mcpField
K
kakunin

kakunin

本地服务
github.com/kakunin-ai安全17 周前更新

关于 kakunin

@kakunin/mcp 是用于 AI Agent 身份与合规管理的 MCP 服务,连接 Kakunin API。它可验证操作权限、查看风险评分,并将行为事件追加到审计日志。

主要功能

  1. 01验证操作范围和授权状态
  2. 02查看滚动风险评分与趋势
  3. 03向不可变审计日志追加事件
  4. 04检查证书和财务限额

适用场景

  1. 01执行前验证 Agent 操作权限
  2. 02查看 Agent 风险状态
  3. 03记录 Agent 行为事件
  4. 04核查允许的操作和交易限额

MCP 相关

向兼容 MCP 的运行环境提供 Kakunin API 工具,用于验证 Agent 操作范围、查询风险评分和记录审计日志。需要 Kakunin API 密钥和 Agent ID。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"kakunin-ai-kakunin": {
"command": "npx",
"args": [
"-y",
"@kakunin/mcp"
],
"env": {
"KAKUNIN_API_KEY": "<KAKUNIN_API_KEY>",
"KAKUNIN_AGENT_ID": "<KAKUNIN_AGENT_ID>"
}
}
}
}
启动命令npx -y @kakunin/mcp
需要配置的环境变量
KAKUNIN_API_KEY密钥Kakunin API key (kak_live_... or kak_test_...). Obtain at https://kakunin.ai/dashboard.
KAKUNIN_AGENT_IDID of the agent this MCP server acts on behalf of (agt_...).

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@kakunin/mcp0.2.4

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
venuestring否正在访问的交易场所或系统(可选,例如 "euronext"、"xetra")。
actionstring是Agent 想要执行的操作或调用的端点。可以是范围字符串(例如 "write:invoices")、API 路径(例如 "/api/v1/execute_trade"),也可以是纯文本描述(例如 "initiate EUR/USD trade on euronext for 50000 USD")。
amount_usdnumber否用于财务范围强制执行的交易金额(USD,可选)。

详细介绍

@kakunin/mcp — 用于 AI Agent 身份与合规的 MCP 服务

OpenSSF Scorecard kakunin-mcp MCP server

kakunin-mcp MCP server

这是 Kakunin AI Agent 合规 API 的 Model Context Protocol 服务。AI Agent 可以在 Claude、Cursor 或任何兼容 MCP 的运行时中自行验证权限范围、检查自身风险评分并记录行为事件。

npx @kakunin/mcp

工具

verify_agent_scope

在执行操作前,检查此 Agent 是否获准执行该操作。验证有效的 X.509 证书、permitted_actions 权限范围、财务限额和吊销状态。

{
  "action": "initiate EUR/USD trade on euronext for 50000 USD",
  "venue": "euronext",
  "amount_usd": 50000
}

返回 { allowed: true|false, reason, certificate_status, permitted_actions }。

check_risk_score

获取 Agent 滚动 30 天的风险评分、等级(low/medium/high)、变化趋势和可操作的建议。无需输入。

audit_log_append

向 Agent 的不可变审计日志追加行为事件。返回风险评分和事务 ID。评分 ≥ 0.85 的事件会自动触发证书吊销检查。

{
  "action_type": "transaction_initiated",
  "details": { "amount_usd": 50000, "venue": "NYSE" }
}

设置

先决条件: Node ≥ 18,以及从 kakunin.ai/dashboard 获取的 Kakunin API 密钥和 Agent ID。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kakunin": {
      "command": "npx",
      "args": ["-y", "@kakunin/mcp"],
      "env": {
        "KAKUNIN_API_KEY": "kak_live_...",
        "KAKUNIN_AGENT_ID": "agt_..."
      }
    }
  }
}
环境变量
变量必需描述
KAKUNIN_API_KEY✅API 密钥(kak_live_... 或 kak_test_...)
KAKUNIN_AGENT_ID✅此服务代表其行事的 Agent ID
KAKUNIN_BASE_URL可选覆盖 API 基础地址(默认:https://kakunin.ai)

沙盒模式

使用 kak_test_... 密钥进行开发——连接沙盒 CA,无费用,每天可免费使用 100 个证书。

完整文档见 docs.kakunin.ai。

贡献者

感谢所有贡献者(表情符号说明)——无论是代码贡献还是其他贡献:

欢迎任何形式的贡献——本项目遵循 all-contributors 规范。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。