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。

🔗 相關倉庫