内容
# @kakunin/mcp
[](https://scorecard.dev/viewer/?uri=github.com/nqzai/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) AI 代理合规 API 的模型上下文协议服务器。允许 AI 代理自行验证范围、检查其自身风险评分，并记录行为事件 — 所有这些都可以在 Claude、Cursor 或任何 MCP 兼容的运行时环境中完成。
```bash
npx @kakunin/mcp
```
## 工具
### `verify_agent_scope`
在执行操作之前，检查该代理是否被授权执行该操作。验证活动 X.509 证书、允许的操作范围、财务限制和撤销状态。
```json
{
"action": "在 euronext 发起 50000 美元的 EUR/USD 交易",
"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 密钥 + 来自 [kakunin.ai/dashboard](https://kakunin.ai/dashboard) 的代理 ID。
### Claude 桌面版
添加到 `~/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) 规范。
