Hejdar

hejdar-mcp

Hejdar 的 MCP 服务（Hejdar）——为 AI Agent 提供运行时策略执行。

此服务将 hejdar_evaluate 作为 MCP 工具公开。任何兼容 MCP 的 Agent（Claude、ChatGPT、Cursor、自定义 Agent）都可以调用它，在执行操作之前检查该操作是否符合组织策略。

此 MCP 服务是 Hejdar API（POST /v1/evaluate）的轻量封装，不包含策略逻辑——所有决策均来自你在 Hejdar 组织中配置的策略。

快速开始

1. 安装

pip install hejdar-mcp

也可以使用 uvx 直接运行：

uvx hejdar-mcp

2. 获取 API 密钥

在 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）：

{
  "mcpServers": {
    "hejdar": {
      "command": "uvx",
      "args": ["hejdar-mcp"],
      "env": {
        "HEJDAR_API_KEY": "hejdar_sk_your_key_here"
      }
    }
  }
}

Claude Code

将以下内容添加到 Claude Code MCP 设置中：

{
  "mcpServers": {
    "hejdar": {
      "command": "uvx",
      "args": ["hejdar-mcp"],
      "env": {
        "HEJDAR_API_KEY": "hejdar_sk_your_key_here"
      }
    }
  }
}

直接使用（stdio）

export HEJDAR_API_KEY=hejdar_sk_your_key_here
hejdar-mcp

入门

1. 安装：pip install hejdar-mcp 或 uvx hejdar-mcp
2. 获取 API 密钥——请通过 [email protected] 联系我们，或访问 hejdar.com
3. 配置 MCP 客户端（参见上方的配置示例）

工具：hejdar_evaluate

根据组织的安全策略评估 Agent 操作。

输入：

参数	类型	必填	描述
action_type	string	是	READ、WRITE、DELETE、TRANSFER 或 EXECUTE（接受 UPDATE 作为 WRITE 的别名，与 Hejdar API 一致）
resource	string	是	目标资源，例如 customer_database
agent_name	string	否	调用该工具的 Agent 名称，例如 hr-assistant
context	object	否	任意格式的元数据（部门、user_id、原因等）

输出：

{
  "decision": "DENY",
  "policy_id": "pol_abc123",
  "reason": "Deletion of customer data requires manager approval",
  "risk_level": "HIGH"
}

decision 的取值之一：ALLOW、DENY、WOULD_DENY。

系统提示词模式

为获得最佳效果，请将以下内容添加到 Agent 的系统提示词中：

You have access to the hejdar_evaluate tool. Before performing any action
that reads, writes, deletes, transfers data, or executes commands on
external systems, you MUST call hejdar_evaluate first.

If hejdar_evaluate returns DENY or WOULD_DENY, do NOT proceed with the
action. Instead, inform the user that the action was blocked by policy
and include the reason provided.

环境变量

变量	必填	默认值	描述
HEJDAR_API_KEY	是	—	你的 Hejdar API 密钥
HEJDAR_API_URL	否	https://api.hejdar.com	API 基础 URL（用于可自托管部署）

安全

• API 密钥仅从环境变量读取——绝不硬编码，也不会暴露在工具输入/输出中
• 所有输入在转发到 API 之前都会经过验证和清理
• 错误响应绝不会泄露内部详情、API 密钥或堆栈跟踪
• 所有 API 调用均强制使用 TLS

开发

git clone https://github.com/ARKALDA/hejdar-mcp.git
cd hejdar-mcp
pip install -e ".[dev]"
pytest

许可证

MIT