MCP

🛰️ DarkMatter MCP 服务器

通用 MCP 服务器，为 AI 代理的决策与操作生成 Context Passport 记录。

可将本服务器接入任何兼容 MCP 的客户端（Claude Code、Cursor、Cline、Continue、ChatGPT Desktop、Zed、Goose 等），为你的代理提供一套 commit / verify / replay / export 工具集，生成可验证、防篡改的记录。

🏢 出品方：DarkMatter

📐 标准实现：Context Passport v2.0（CC0 开源标准）。本服务器生成的记录采用 RFC 8785（JCS）规范化处理，在 Python 与 TypeScript 参考 SDK 之间字节级等价。

🚀 快速开始

📦 安装

在你的 MCP 客户端配置文件中（如 claude_desktop_config.json、Cursor 的 mcp.json 等）添加以下内容：

{
  "mcpServers": {
    "darkmatter": {
      "command": "npx",
      "args": ["-y", "@darkmatterhub/mcp-server"]
    }
  }
}

重启客户端后，代理即可使用以下五个工具：

📝 捕获内容说明

本服务器只捕获代理（或用户）显式调用 darkmatter_commit 的内容。若需要在不显式调用的情况下自动捕获所有工具调用，请参见下方的 自动捕获 章节。

💡 示例：代理调用流程

User:    Approve the refund for order #1247 and record the decision.
Agent:   Calls refund_order(1247).
Agent:   Calls darkmatter_commit({
           input: "Approve refund for order #1247",
           output: "Approved. $84.00 refunded to original payment method.",
           role: "compliance",
           event_type: "commit"
         })
Result:  { ok: true, passport: {...}, verify_url: "https://darkmatterhub.ai/r/ctx_..." }

生成的 passport 具备以下特性：

• 已签名（若已配置密钥）
• 哈希链式连接到会话中的上一次 commit
• 本地存储路径为：~/.darkmatter/mcp/<session_id>/chain.jsonl

💾 存储

默认策略：完全本地存储，passport 永不离开本机。

~/.darkmatter/mcp/
├── default/
│   ├── chain.jsonl        # 所有 commit 的仅追加（append-only）流
│   └── latest.json        # 最新 passport（作为下一次 commit 的父节点）
└── <other-session-id>/
    └── ...

☁️ 转发到 DarkMatter 服务器（可选）

除了本地存储外，若希望将每个 passport 转发到 DarkMatter 接收服务器，可设置以下环境变量：

export DARKMATTER_API_KEY="dm_sk_..."

💡 使用建议

转发为尽力而为（best-effort）模式，永不阻塞代理的工具调用。本地存储始终是数据的真实来源（source of truth）。

🔄 自动捕获

MCP 服务器仅捕获代理显式调用的内容。若希望在特定开发工具中自动捕获所有工具调用与轮次边界（无需代理记得调用 darkmatter_commit），可安装以下针对特定开发工具的适配器：

每个适配器都接入其对应开发工具的事件生命周期，并通过本 MCP 服务器的 darkmatter_commit 工具路由事件。统一端点，多种捕获入口。

🔍 验证

生成的记录均为合规的 Context Passport v2.0 产物。可使用任意符合规范的实现来验证：

pip install context-passport context-passport-conformance
context-passport-conformance --level signed     # 9/9 vectors, no --vectors-dir needed

一致性测试包已将其测试向量打包在 wheel 内，因此这一行命令即可对公开参考套件进行验证。

或者直接使用离线参考验证器对 JSONL 文件进行校验：

import json
from context_passport import verify_chain

with open("~/.darkmatter/mcp/default/chain.jsonl") as f:
    chain = [json.loads(line) for line in f]

print(verify_chain(chain))  # True if intact, False if tampered

🤔 为什么选择 MCP

MCP（Model Context Protocol）正在成为 AI 工具的通用互操作层。只需编写一次服务器，即可在所有兼容 MCP 的客户端中运行，无需为每个客户端单独编写集成代码。

📚 延伸阅读

关于更宏观的架构设计理念，请参阅 Context Passport for MCP 提案。

📄 许可证

本项目采用 Apache-2.0 许可证，详见 LICENSE 文件。

本服务器实现的 Context Passport schema 单独以 CC0 1.0 发布，托管于 github.com/contextpassport/spec。

🔗 相关仓库