内容
# @kakunin/mcp — 人工智能代理身份与合规的MCP服务器
[](https://scorecard.dev/viewer/?uri=github.com/kakunin-ai/kakunin-mcp)
[](https://glama.ai/mcp/servers/nqzai/kakunin-mcp)
<a href="https://glama.ai/mcp/servers/nqzai/kakunin-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/nqzai/kakunin-mcp/badges/card.svg" alt="kakunin-mcp MCP服务器" />
</a>
适用于 [Kakunin](https://kakunin.ai) 人工智能代理合规API的模型上下文协议（MCP）服务器。允许人工智能代理自我验证范围、检查其自身风险评分并记录行为事件 — 所有这些都可以在Claude、Cursor或任何MCP兼容的运行时环境中完成。
```bash
npx @kakunin/mcp
```
## 工具
### `verify_agent_scope`
在执行操作之前，检查该代理是否被授权执行该操作。验证活动X.509证书、允许的操作范围、财务限制和撤销状态。
```json
{
"action": "在euronext上启动EUR/USD交易，金额为50000美元",
"venue": "euronext",
"amount_usd": 50000
}
```
返回 `{ allowed: true|false, reason, certificate_status, permitted_actions }`.
### `check_risk_score`
获取代理的滚动30天风险评分、风险等级（`低`/`中等`/`高`）、漂移趋势和可行的指导。无需输入。
### `audit_log_append`
将行为事件追加到代理的不可篡改的审计日志中。返回风险评分 + 交易ID。事件评分为≥ 0.85会自动触发证书撤销检查。
```json
{
"action_type": "transaction_initiated",
"details": { "amount_usd": 50000, "venue": "NYSE" }
}
```
## 安装
**前提条件：** Node ≥ 18，Kakunin API密钥 + 代理ID来自 [kakunin.ai/dashboard](https://kakunin.ai/dashboard)。
### Claude Desktop
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```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` | ✅ | 服务器代表其操作的代理ID |
| `KAKUNIN_BASE_URL` | 可选 | 覆盖API基础（默认：`https://kakunin.ai`） |
## 沙盒模式
在开发过程中使用 `kak_test_...` 密钥 — 访问沙盒CA，无成本，每天100个免费证书。
完整文档请参阅 [docs.kakunin.ai](https://docs.kakunin.ai)。
## 贡献者
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<!-- ALL-CONTRIBUTORS-BADGE:END -->
感谢所有贡献者（[表情符号密钥](https://allcontributors.org/docs/en/emoji-key)）— 代码和非代码贡献：
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
欢迎任何类型的贡献 — 该项目遵循 [all-contributors](https://allcontributors.org) 规范。
