CWI MCP Server

cwi-mcp-server

CWI 的只读 MCP（Model Context Protocol）服务。包含 7 个工具、零依赖，采用 stdio 传输方式——将其连接到任何 MCP 客户端（Claude Desktop、Claude Code、Cursor 或其他 Agent），即可在自己的运行环境中读取 CWI 的信任基础设施。

你将获得：

• Gear Ledger 读取工具（5 个工具）——CWI Agent 公司的实时公开来源记录：版本、完整状态、Agent 及其在线状态、任务摘要、单个任务详情。
• trust_verdict——使用 CWI Verdict Engine v1.0.0 评估 Agent 的信任度（结果确定且以证据为依据；数据不足时会返回 insufficient-data，而非捏造评分）。
• needledrop_verify——验证任意 NEEDLE DROP 放置记录账本（cwi-needledrop/v1）的哈希链完整性。

**只读就是真正只读。**没有写入工具、没有签名、没有在线状态心跳、没有创建任务，也不会修改状态。服务不持有任何机密信息：代码、配置或日志中均无令牌、密码或密钥。

别光相信我们——请查看 VERIFY.md，了解如何在 5 分钟内亲自逐项核验所有声明。

安装（复制粘贴）

要求：PATH 中需有 Node ≥ 18 和 python3。无需安装任何内容——零依赖。

git clone https://github.com/CumulativeWebInc/cwi-mcp-server.git
cd cwi-mcp-server
node test.js       # expect: 28/28 tests passed
node test-http.js  # expect: 13/13 HTTP tests passed

就是这样。server.js 就是服务。

**初次使用？**请从 10 步配置指南开始（每一步都经过测试）：https://cumulativewebinc.github.io/cwi-learn/EQUIP-GUIDE.md

一键安装

• 在 Cursor 中安装 — 打开 Cursor，并预先填入 cwi MCP 配置（stdio：node /absolute/path/to/cwi-mcp-server/server.js）。请将路径替换为你的实际检出路径。
• 在 VS Code 中安装 — 跳转到 vscode:mcp/install，并预先填入相同配置。

连接你的 MCP 客户端

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "cwi": {
      "command": "node",
      "args": ["/absolute/path/to/cwi-mcp-server/server.js"]
    }
  }
}

**Claude Code / 任何 stdio MCP 客户端：**格式相同——命令为 node，参数为一个：server.js 的绝对路径。传输方式为 stdio：stdin 中每行一个 JSON-RPC 对象，响应写入 stdout。

HTTP 桥接（适用于 Meta Muse 自定义连接器及其他 HTTP MCP 客户端）

server-http.js 是一个零依赖的可流式 HTTP前端，提供完全相同的 7 个工具——使用相同的代码路径，没有重复代码（server.js 的 handleMessage() 会处理每个请求）。它采用 Meta Muse 自定义连接器使用的传输方式：通过 POST /mcp 发送 JSON-RPC 2.0，无状态（无需会话 ID），通知返回 202，GET /mcp 返回 405。

node test-http.js   # expect: 13/13 HTTP tests passed
PORT=3000 BIND=0.0.0.0 node server-http.js
# -> cwi-mcp-server-http v0.3.0 listening on 0.0.0.0:3000 (POST /mcp)

将其托管在任何具有公开 HTTPS URL 的常开机器上（Railway、Render、Fly.io、VPS 等），然后在聊天中告知 Muse 将该 /mcp URL 作为自定义连接器连接。网络传输同样遵循只读原则：请求正文上限为 1 MB，每个 IP 的速率限制为 60 次请求/分钟，不支持批处理。GET / 提供人工可读的信息页面，GET /health 提供 JSON 健康检查。

托管（支持 Docker）

仓库附带 Dockerfile（Node 20 + python3）和 render.yaml（Render Blueprint）——该桥接服务已可部署到任何容器托管平台。

• **Render（免费，无需信用卡）：**在 Render 中选择 New → Blueprint → 连接此仓库。Blueprint 会部署带有 /health 检查的 Docker 服务。免费套餐在闲置 15 分钟后休眠（冷启动约需 1 分钟）——用于按需调用 MCP 完全够用。
• 任何 Docker 主机（VPS、Zeabur、Cloud Run 等）：运行 docker build -t cwi-mcp .，然后使用 -p 7860:7860 启动；MCP 端点为 https://<host>/mcp。
• Hugging Face Spaces：免费套餐不可用（已于 2026-09-20 验证——API 返回 402 Payment Required：Gradio 和 Docker Spaces 现要求订阅 PRO；只有静态 Spaces 仍免费）。

7 个工具

#	工具	参数	返回值
1	ledger_state_version	无	{version, updated_at, sha, tasks, agents}
2	ledger_state_get	fields（可选 string[]）	完整台账状态，或所选顶层键
3	ledger_agents	无	所有已注册 Agent + 最新在线状态心跳
4	ledger_tasks	state（可选 enum）	任务摘要；按生命周期状态筛选
5	ledger_task_get	task_id（必填）	完整任务详情，包括状态历史和工件
6	trust_verdict	input（必填 object）	信任评分，或如实返回 insufficient-data
7	needledrop_verify	file（可选路径）	{file, ok, messages} 链完整性判定

示例 — 读取台账版本

// tools/call {"name": "ledger_state_version", "arguments": {}}
{
  "version": 1541,
  "updated_at": "2026-09-17T11:23:35Z",
  "sha": "3b2b46c8b8e14e0a3351e8896c6bd75e53391cde",
  "tasks": 38,
  "agents": 11
}

示例 — 评估信任度（或如实拒绝）

// tools/call {"name": "trust_verdict", "arguments": {"input": {
  "engine_version": "1.0.0",
  "subject": {"agent_id": "some_agent"},
  "context": "agent-trust",
  "observed_at": "2026-09-17T12:00:00Z",
  "signals": {"erc8004": [], "needle_drop": [], "first_spin": []}
}}}
{
  "status": "insufficient-data",
  "score": null,
  "missing": ["at least 3 verified signals across 2 families"],
  "input_sha256": "9f2c…"
}

证据为空 → insufficient-data，绝不编造数字。这正是该引擎的核心。提供真实、可引用的证据，就能得到真实评分；输出包含 input_sha256，任何人都能逐字节复现。

示例 — 验证 NEEDLE DROP 台账

// tools/call {"name": "needledrop_verify", "arguments": {}}
{
  "file": "vendor/needledrop/example-ledger.json",
  "ok": true,
  "messages": ["chain intact"]
}

将 file 指向任意绝对路径下的 cwi-needledrop/v1 台账，即可验证该台账。被篡改的条目会验证失败 — 试试看：复制示例台账，修改一个字节，观察 ok 变为 false，并显示条目名称。

台账读取在你的机器上如何工作

在 CWI 的基础设施上，工具通过规范台账 CLI 读取数据。在你的机器上，它们从 CWI 的公开 gear-ledger 仓库读取相同的字节 — 无需身份验证，也无需设置。（trust_verdict 和 needledrop_verify 完全在本地运行，绝不会访问网络。）

文件

• server.js — 服务（7 个工具、stdio、零依赖）
• server-http.js — streamable-HTTP 桥接（无状态 POST /mcp、零依赖）
• test.js — 完整协议 + 工具测试框架（node test.js → 28/28）
• test-http.js — HTTP 桥接测试框架（node test-http.js → 13/13）
• VERIFY.md — 零信任验证指南：自行检查所有内容
• EQUIPS.md — 仅包含回执的公开外部配备日志
• agent-card.json — 供 Agent 发现的机器可读卡片
• vendor/cwi-verdict-engine-v1.0.0/ — 随附的判定引擎 （逐字节相同的副本；参见 vendor/cwi-verdict-engine-v1.0.0/SOURCE.md）
• vendor/needledrop/ — ledger.py + 架构 + 含 2 条目的示例台账 （条目由真实的 ledger.py 封存，并明确标注为示例）
• examples/ — 2026-09-17 运行的真实判定输出

成果、衡量方式、终止规则

• 必须实现的成果： 外部 Agent 使用附带其身份信息的工具调用。回执记录在 EQUIPS.md 中。
• 衡量方式： 可核查回执对应的真实工具调用。
• 终止规则： 到 2026-10-01 仍无外部调用 → 停用该 MCP 服务作为采用入口（保留供内部使用），并记录经验教训。

许可证

MIT — 参见 LICENSE。