内容
# hejdar-mcp
Hejdar MCP 服务器 — 面向 AI 代理的运行时策略执行。
本服务器以 `hejdar_evaluate` 作为 MCP 工具暴露。任何与 MCP 兼容的代理（Claude、ChatGPT、Cursor、自定义）都可以调用它来检查在执行某个操作前，该操作是否得到组织策略的允许。
MCP 服务器是 Hejdar API（`POST /v1/evaluate`）的薄封装。它不包含任何策略逻辑 — 所有决策均来自您 Hejdar 组织配置的策略。
## 快速入门
### 1. 安装
```bash
pip install hejdar-mcp
```
或使用 `uvx` 直接运行：
```bash
uvx hejdar-mcp
```
### 2. 获取您的 API 密钥
在 [app.hejdar.com](https://app.hejdar.com) 注册并在 **设置 → API 密钥** 中创建 API 密钥。
### 3. 配置您的 MCP 客户端
#### Claude Desktop
添加到您的 Claude Desktop 配置文件（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`，Windows：`%APPDATA%\Claude\claude_desktop_config.json`）：
```json
{
"mcpServers": {
"hejdar": {
"command": "uvx",
"args": ["hejdar-mcp"],
"env": {
"HEJDAR_API_KEY": "hejdar_sk_your_key_here"
}
}
}
}
```
#### Claude Code
添加到您的 Claude Code MCP 设置：
```json
{
"mcpServers": {
"hejdar": {
"command": "uvx",
"args": ["hejdar-mcp"],
"env": {
"HEJDAR_API_KEY": "hejdar_sk_your_key_here"
}
}
}
}
```
#### 直接（stdio）
```bash
export HEJDAR_API_KEY=hejdar_sk_your_key_here
hejdar-mcp
```
## 入门指南
1. 安装：`pip install hejdar-mcp` 或 `uvx hejdar-mcp`
2. 获取 API 密钥 — 请联系我们：hello@hejdar.com 或访问 [hejdar.com](https://hejdar.com)
3. 配置您的 MCP 客户端（参见上面的配置示例）
## 工具：`hejdar_evaluate`
根据您的组织安全策略评估代理操作。
**输入：**
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `action_type` | 字符串 | 是 | `READ`、`WRITE`、`DELETE`、`TRANSFER` 或 `EXECUTE` |
| `resource` | 字符串 | 是 | 目标资源，例如 `customer_database` |
| `agent_name` | 字符串 | 否 | 调用代理的名称，例如 `hr-assistant` |
| `context` | 对象 | 否 | 自由格式元数据（部门、user_id、原因等） |
**输出：
```json
{
"decision": "DENY",
"policy_id": "pol_abc123",
"reason": "Deletion of customer data requires manager approval",
"risk_level": "HIGH"
}
```
`decision` 的可能值为：`ALLOW`、`DENY`、`WOULD_DENY`。
## 系统提示模式
为了获得最佳结果，请在您的代理系统提示中添加以下内容：
```
您有权访问 hejdar_evaluate 工具。在执行任何读取、写入、删除、传输数据或在外部系统上执行命令的操作之前，您必须首先调用 hejdar_evaluate。
如果 hejdar_evaluate 返回 DENY 或 WOULD_DENY，请勿继续执行该操作。相反，请通知用户该操作被策略阻止，并包含提供的理由。
```
## 环境变量
| 变量 | 必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `HEJDAR_API_KEY` | 是 | — | 您的 Hejdar API 密钥 |
| `HEJDAR_API_URL` | 否 | `https://api.hejdar.com` | API 基址 URL（适用于自托管） |
## 安全
- API 密钥仅从环境变量中读取 — 绝不硬编码或在工具输入/输出中暴露
- 所有输入在转发到 API 之前都会被验证和净化
- 错误响应绝不会泄露内部细节、API 密钥或堆栈跟踪
- 所有 API 调用都强制使用 TLS
## 开发
```bash
git clone https://github.com/ARKALDA/hejdar-mcp.git
cd hejdar-mcp
pip install -e ".[dev]"
pytest
```
## 许可证
MIT
