Agent Trust (mnki-mcp) MCP Server已验证已精选

什么是 Agent Trust (mnki-mcp)？

Agent Trust (mnki-mcp) 是一个本地 MCP 代理，位于 MCP 客户端与任意 MCP 服务器之间，在每个 tools/call 到达服务器之前，根据智能体的身份、被委托的权限和策略进行校验，并为每个决定返回签名证据。

它属于 MNKI 的 Agent Trust 项目。Agent Trust 是一套开放规范和参考实现，用于证明自主 AI 智能体被授权做什么：身份、带衰减的委托、持有证明、证明声明和防篡改的溯源记录，基于 JWS、OAuth/OIDC、SPIFFE/WIMSE、AuthZEN、OpenID Federation、MCP 和 A2A 构建。代理、CLI、SDK 和验证器均以 Apache-2.0 开源，在本地模式下无需账号即可运行。mnki.com 上的托管控制台另外提供审批、账本和智能体总览。

如何使用 Agent Trust (mnki-mcp)？

你需要安装 Node.js。先运行无需账号的演示：

npx mnki-cli demo

一个发票智能体最多可退款 €5,000：€47,000 被拒绝并附上证据列表，€420 被允许，€3,200 需要人工审批。

要保护你已经在运行的 MCP 服务器，先扫描本机，再让 mnki protect 改写客户端配置。它默认是试运行，并从 observe 模式开始：

npx mnki-cli scan
npx mnki-cli protect --client cursor --server github --agent my-agent
npx mnki-cli protect --client cursor --server github --agent my-agent --apply
npx mnki-cli protect report --server github

mnki protect rollback 可撤销更改。准备好拦截调用时，加上 --mode enforce。

Claude Desktop

手动配置时，stdio 服务器条目在 --upstream -- 之后包裹原始命令：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mnki-mcp", "--agent", "agt_your_agent", "--server", "github", "--mode", "observe", "--upstream", "--", "npx", "-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN", "MNKI_URL": "https://mnki.com", "MNKI_API_KEY": "YOUR_MNKI_API_KEY" }
    }
  }
}

MNKI_URL 和 MNKI_API_KEY（或 mnki init）告诉代理由哪个控制台进行校验；MNKI_IDENTITY_FILE 指向用于签名请求的智能体密钥。

Claude Code

以 JSON 形式添加相同的条目：

claude mcp add-json github '{"command":"npx","args":["-y","mnki-mcp","--agent","my-agent","--server","github","--mode","observe","--upstream","--","npx","-y","@modelcontextprotocol/server-github"]}'

Cursor

对于远程 HTTP 服务器，把代理指向上游 URL：

{
  "mcpServers": {
    "billing": {
      "command": "npx",
      "args": ["-y", "mnki-mcp", "--agent", "agt_your_agent", "--server", "billing", "--mode", "enforce", "--amount-map", "create_payment=amount:currency", "--upstream-url", "https://mcp.example.com/mcp", "--upstream-header", "Authorization=Bearer YOUR_UPSTREAM_TOKEN"]
    }
  }
}

VS Code

{
  "servers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mnki-mcp", "--agent", "agt_your_agent", "--server", "playwright", "--mode", "warn", "--upstream", "--", "npx", "@playwright/mcp@latest"]
    }
  }
}

仓库中还提供 Windsurf 配置片段和 Docker sidecar 镜像 ghcr.io/mnkiagentos/mnki-mcp。

Agent Trust (mnki-mcp) 的主要功能

• 校验每个 tools/call，其余消息原样转发。
• 可包裹 stdio 命令或 Streamable HTTP 端点。
• 四种模式：observe（仅记录，默认）、warn、require_approval 和 enforce。
• enforce 模式下返回清晰的 JSON-RPC 错误：-32003 拒绝（附证据），-32001 需要审批、被拒绝或已过期，-32005 超出校验配额，-32006 无法连接 Agent Trust。
• 本地模式可离线运行；连接控制台后可使用人工审批、集中策略和防篡改账本。
• TypeScript、Python（pip install mnki）和 Go 共用同一校验核心，并由 1 至 3 级的开放一致性测试向量检验。
• 发布版本附带 npm 和 PyPI 来源证明、SBOM 以及 cosign 签名的校验和。

Agent Trust (mnki-mcp) 的使用场景

• 影子测试策略：在 observe 模式下通过代理运行 GitHub MCP 服务器，然后查看 mnki protect report，了解哪些调用本会被拒绝。
• 限制付款：在账单类 MCP 服务器上，用 --amount-map 映射 create_payment 的金额并强制执行退款上限，于是 €47,000 被拒绝，€420 正常执行。
• 人工审批：在 require_approval 或 enforce 模式下，高风险调用会等待有人在控制台批准。
• 审计：保留签名记录，说明哪个智能体在哪个委托下调用了哪个工具。
• 盘点：npx mnki-cli scan 列出本机上智能体可使用的所有 MCP 服务器和 API 密钥。

Agent Trust (mnki-mcp) 常见问题排查

• 什么都没有被拦截。 默认模式是 observe，只记录不拦截。报告确认无误后切换到 --mode enforce。
• 出现 -32006 错误。 无法连接 Agent Trust。在 observe 和 warn 模式下代理会直接转发；请检查 MNKI_URL 和网络。
• 出现 -32005 错误。 已达到校验配额。免费云套餐每月包含 10,000 次托管校验。
• 改错了配置。 mnki protect 会先显示差异；已应用的更改可用 mnki protect rollback 撤销。