Colber

@colber/mcp

面向 Colber 的官方 Model Context Protocol (MCP) 服务——将 Colber 的 5 个模块（声誉、记忆、可观测性、协商、保险）以及 Agent 身份服务作为 MCP 工具提供给任何兼容的 AI Agent。

将 Colber 接入 Claude Desktop、Claude Code、Cline、Continue 或任何其他支持 MCP 的客户端，你的 Agent 就能立即协商、为交易投保、共享记忆、推送可观测性数据，并检查达到链上级别的声誉——所有功能都通过统一的工具接口提供。

---

什么是 Colber？

Colber 是面向 Agent 经济的信任、协作与连续性层。MoonPay、Coinbase x402 或 Nevermined 等支付轨道负责处理资金，而 Colber 为自主 Agent 提供所需的基础能力，让它们能够相互信任、进行协商、保证交付内容、追踪交互并跨会话记忆信息。

此软件包是官方 MCP 网关。它以轻量进程的形式运行，将 MCP tools/call 请求转换为针对 Colber 后端服务的 HTTP 调用。

快速开始

1. Claude Desktop

将以下内容添加到 MCP 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "colber": {
      "command": "npx",
      "args": ["-y", "@colber/mcp"],
      "env": {
        "COLBER_BASE_URLS": "{\"identity\":\"https://api.colber.dev/identity\",\"reputation\":\"https://api.colber.dev/reputation\",\"memory\":\"https://api.colber.dev/memory\",\"observability\":\"https://api.colber.dev/observability\",\"negotiation\":\"https://api.colber.dev/negotiation\",\"insurance\":\"https://api.colber.dev/insurance\"}",
        "COLBER_AUTH_TOKEN": "<your-token-or-leave-empty>"
      }
    }
  }
}

重启 Claude Desktop。工具栏中会显示 27 个 Colber 工具。

2. Claude Code

claude mcp add colber npx -- -y @colber/mcp

或者直接编辑 ~/.claude.json：

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

3. Cline

编辑 mcp_settings.json（路径因平台而异——请参阅 Cline 文档）：

{
  "mcpServers": {
    "colber": {
      "command": "npx",
      "args": ["-y", "@colber/mcp"],
      "env": {
        "COLBER_BASE_URLS": "{...same JSON map as above...}"
      }
    }
  }
}

4. Continue

编辑 ~/.continue/config.yaml（或对应的 mcpServers.yaml）：

mcpServers:
  - name: colber
    command: npx
    args:
      - -y
      - '@colber/mcp'
    env:
      COLBER_BASE_URLS: '{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}'

---

可用工具（27 个）

工具名称采用 colber_<module>_<verb> 约定，以避免与用户可能已安装的其他 MCP 服务发生冲突。输入会通过 Zod 在服务端进行验证；错误将作为带有结构化负载（code、message、status、details、traceId）的 MCP isError: true 内容返回。

身份（3 个）

工具	描述
colber_identity_register	根据 Ed25519 公钥注册新的 Agent 身份。
colber_identity_resolve	将 DID 解析为对应的 Agent 记录。
colber_identity_verify	根据与 DID 绑定的公钥验证签名。

声誉（4 个）

工具	描述
colber_reputation_score	获取 Agent 的已签名声誉评分信封（0..1000）。
colber_reputation_history	分页查看交易和反馈历史。
colber_reputation_verify	验证已签名的声誉证明。
colber_reputation_feedback	交易后提交已签名的反馈。

记忆（4 个）

工具	描述
colber_memory_store	持久化新的记忆（文本 + 结构化负载 + 权限）。
colber_memory_retrieve	对调用者可见的记忆进行语义搜索。
colber_memory_update	更新记忆的文本和／或负载。仅限所有者操作。
colber_memory_share	授予其他 Agent 对记忆的读取权限。

可观测性（8）

工具	描述
colber_observability_log	摄取一个或多个日志事件。
colber_observability_trace	摄取一个或多个符合 W3C 标准的跟踪跨度。
colber_observability_query	对日志或跟踪跨度进行结构化搜索。
colber_observability_alert_create	创建声明式告警规则。
colber_observability_alert_get	按 id 读取单条告警规则。
colber_observability_alert_patch	部分更新告警规则。
colber_observability_alert_list	列出某个操作员拥有的告警规则。
colber_observability_alert_delete	删除告警规则。

协商（4）

工具	描述
colber_negotiation_start	创建新的协商（幂等）。
colber_negotiation_propose	提交已签名的提案。
colber_negotiation_counter	提交反提案。
colber_negotiation_settle	通过多方签名敲定交易。

保险（4）

工具	描述
colber_insurance_quote	计算配送交易的保费报价。
colber_insurance_subscribe	创建保单并锁定模拟托管资金。
colber_insurance_claim	根据保单提出索赔。
colber_insurance_status	读取完整的保单状态（保单 + 托管资金 + 索赔）。

---

配置

变量	默认值	说明
COLBER_MCP_TRANSPORT	stdio	stdio（本地）或 http（远程/SSE）。CLI --transport= 优先。
COLBER_MCP_HTTP_PORT	14080	仅用于 HTTP 传输。CLI --port= 优先。
COLBER_MCP_HTTP_HOST	0.0.0.0	仅用于 HTTP 传输。CLI --host= 优先。
COLBER_BASE_URLS	本地 β-VM 端口	JSON 映射。键：identity、reputation、memory、observability、negotiation、insurance。
COLBER_AUTH_TOKEN	（未设置）	可选。作为 Authorization: Bearer <token> 发送给每个后端服务。
COLBER_LOG_LEVEL	info	pino 级别：trace debug info warn error。

完整示例见 .env.example。

HTTP 传输

对于共享 / 云部署，请改用 Streamable HTTP 传输：

npx @colber/mcp --transport=http --port=14080

随后，服务会公开以下端点：

• POST /mcp — 客户端 → 服务端 JSON-RPC 帧（SDK 会直接以内联方式响应， 根据内容协商结果返回 JSON 或 SSE 流）。
• GET /mcp — 打开独立的服务端 → 客户端 SSE 流，用于带外通知。两个方向都需要 Mcp-Session-Id 标头；客户端会在初始 initialize POST 的响应中收到会话 ID。
• GET /healthz — 健康探测（{ status: "ok", tools: 27 }）。

本地开发

pnpm install
pnpm --filter @colber/mcp typecheck
pnpm --filter @colber/mcp test
pnpm --filter @colber/mcp build
node apps/mcp-server/dist/server.js

Docker

docker build -t colber/mcp:0.1.0 -f apps/mcp-server/Dockerfile .
docker run --rm -p 14080:14080 \
  -e COLBER_BASE_URLS='{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}' \
  colber/mcp:0.1.0

许可证

Apache-2.0 — 请参阅仓库根目录中的 LICENSE 文件。

链接

• Colber — 官方网站。
• GitHub 仓库。
• Model Context Protocol 规范。
• Anthropic MCP TypeScript SDK。