Ceres V2 MCP Server

MCP (Model Context Protocol) 服务，将 Ceres V2 邀请系统暴露为 20 个标准 MCP 工具。

接入方式

npm 安装

npm install @ceresv2/mcp
npx @ceresv2/mcp

OpenClaw Gateway 配置

{
  "mcpServers": {
    "ceres": {
      "url": "https://ceres.0xainet.top/mcp",
      "transport": "streamable-http"
    }
  }
}

支持链

| chainId | 链 | 原生代币 | |---------|-----|---------| | 1 | ETH | ETH | | 56 | BSC | BNB | | 677 | BotChain | BOT | | 8453 | BASE | ETH | | 19505 | OxaChain L1 | 0x | | 11155111 | Sepolia (testnet) | ETH |

工具列表

只读工具（5 个）

| 工具 | 说明 | 参数 | |------|------|------| | ceres_batch_check | 批量查邀请状态 (≤200 地址) | addresses: string[] | | ceres_stats | 全局统计 (边数/地址数/链) | 无 | | ceres_edges | 分页查询 + 增量同步 | page, limit, since, chainId, order | | ceres_address_graph | 单地址关系图 | address: string | | ceres_network_graph | 全局网络图谱 (Redis 缓存) | 无 |

写操作 / 邀请流程（3 个，结合 TEE 钱包 MCP 使用）

| 工具 | 说明 | 参数 | |------|------|------| | ceres_build_invite | 生成 EIP-712 签名数据 | inviter, invitee, chainId, deadlineSeconds | | ceres_submit_invite | 提交签名到链 | inviter, invitee, chainId, nonce, deadline, signature | | ceres_invite_confirm | 等待上链确认 | invitee, timeoutMs, pollIntervalMs |

运维工具（2 个）

| 工具 | 说明 | 参数 | |------|------|------| | ceres_health | Relayer + Redis + 链健康检查 | 无 | | ceres_sync_trigger | 手动触发全量同步 | type: "invite" \| "did" \| "all" |

邀请绑定流程（结合 TEE 钱包）

AI Agent:
  ① ceres_build_invite(inviter, invitee, chainId)
       → { domain, types, primaryType, message }

  ② TEE Wallet MCP: signTypedData(domain, types, message)
       → { signature }

  ③ ceres_submit_invite(inviter, invitee, chainId, nonce, deadline, signature)
       → { relayed: true, txHash } 或 { transaction: { to, data } }

  ④ ceres_invite_confirm(invitee)
       → { confirmed: true, inviter, chainId }

Ceress MCP 不持有私钥，签名由外部 TEE 钱包 MCP 完成。

部署

# npm 全局安装
npm install -g @ceresv2/mcp

# 或直接使用 npx
npx @ceresv2/mcp

systemd 服务

# 复制 service 文件
sudo cp ceres-mcp.service /etc/systemd/system/
sudo systemctl enable --now ceres-mcp

# 验证
curl -X POST http://localhost:3083/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

架构

AI Agent / OpenClaw
    │
    ├── ceres_build_invite  ──→  EIP-712 data
    ├── TEE Wallet MCP      ──→  signature
    ├── ceres_submit_invite ──→  Relayer → Chain
    ├── ceres_invite_confirm ─→  DB poll
    ├── ceres_batch_check   ──→  SQLite
    └── ceres_health        ──→  Relayer + Redis

与 SDK 对比

| | SDK (npm) | MCP v2.0 | |---|:--:|:--:| | 安装 | npm install | 一行 JSON | | 语言 | TypeScript | 任何 | | 钱包 | wagmi/viem | 外部 TEE MCP | | 邀请 | useCeresInvite() | build → sign → submit | | 数据 | hooks | 工具调用 | | 适用 | 前端 | AI/后端/自动化 |