Chainweb API

pact-mcp — Pact 和 Chainweb 的 MCP 服务

Model Context Protocol 服务，为你的 AI Agent 提供安全、可审计的访问能力， 用于在 Kadena Chainweb 上进行 Pact 5 开发。

通过 Claude、Cursor、VS Code 或任何兼容 MCP 的客户端运行 REPL 测试、扫描模块中的关键语言陷阱、估算 Gas，以及查询或提交到 Chainweb 节点。每个工具都运行在严格且经过测试的安全基线之上，且任何工具都不会接触私钥。

{
  "mcpServers": {
    "pact": {
      "command": "npx",
      "args": ["-y", "@pact-community/mcp-pact"],
      "env": { "PACT_COMMUNITY_WORKSPACE_ROOT": "/path/to/your/project" }
    }
  }
}

服务

服务	安装	工具	功能
Pact 工具链 — @pact-community/mcp-pact		6	运行 REPL 测试、扫描关键陷阱、估算 Gas、比较接口差异、检查格式
Chainweb API — @pact-community/mcp-chainweb		11	/local 模拟、预签名 /send、轮询、读取表、SPV 证明、部署模块

两者均已列入官方 MCP 注册表，注册名分别为 io.github.Pact-Community-Organization/pact 和 io.github.Pact-Community-Organization/chainweb。

安装

VS Code（一键安装）

正在使用 GitHub Copilot 的 VS Code？只需单击一下即可安装：

按钮会打开 VS Code 并预先填入配置。你也可以在 MCP Servers 视图中搜索，或通过命令行添加：

code --add-mcp '{"name":"pact","command":"npx","args":["-y","@pact-community/mcp-pact"],"env":{"PACT_COMMUNITY_WORKSPACE_ROOT":"${workspaceFolder}","PACT_COMMUNITY_PACT_BIN":"pact"}}'

在 VS Code Insiders 中，请在链接中使用 vscode-insiders:，或在命令行中使用 code-insiders。

Claude Code

claude mcp add pact -e PACT_COMMUNITY_WORKSPACE_ROOT=/path/to/your/project \
  -- npx -y @pact-community/mcp-pact

任意 MCP 客户端

将两个服务添加到客户端配置中：

{
  "mcpServers": {
    "pact": {
      "command": "npx",
      "args": ["-y", "@pact-community/mcp-pact"],
      "env": {
        "PACT_COMMUNITY_WORKSPACE_ROOT": "/path/to/your/project",
        "PACT_COMMUNITY_PACT_BIN": "pact"
      }
    },
    "chainweb": {
      "command": "npx",
      "args": ["-y", "@pact-community/mcp-chainweb"],
      "env": {
        "PACT_COMMUNITY_WORKSPACE_ROOT": "/path/to/your/project",
        "PACT_COMMUNITY_CHAINWEB_MODE": "devnet",
        "PACT_COMMUNITY_CHAINWEB_PROFILE": "devnet",
        "PACT_COMMUNITY_CHAINWEB_BASE_URL": "http://localhost:8081",
        "PACT_COMMUNITY_CHAINWEB_NETWORK_ID": "development"
      }
    }
  }
}

每个服务的 README 都列出了完整的工具清单和环境变量： Pact 工具链 · Chainweb API。

前 10 分钟

1. 安装 Pact CLI — Pact Tooling 使用它运行 REPL 并估算 gas。从 kadena-io/pact-5 下载发行版，将 pact 放入你的 PATH，并通过 pact --version 验证。
2. 将服务添加到客户端，使用上面的配置，并将 PACT_COMMUNITY_WORKSPACE_ROOT 指向你的合约项目。
3. 向你的 Agent 提问：
   • "扫描 contracts/token.pact，查找 Pact 5 中的关键陷阱" — 标记非二进制 +、enforce 中的数据库读取、内置项遮蔽等问题。
   • "运行 tests/token.repl 并总结失败原因" — 使用真实的 Pact 解释器执行文件 并解析结果。
   • "对比 token.pact 和 token-v2.pact 的公共接口" — 报告新增、删除或变更的函数，以及这些变更是否具有破坏性。
   • "链 0 上当前的区块高度是多少？" — 查询 Chainweb 节点。

Pact Tooling 仅使用 CLI 即可运行——无需节点。Chainweb API 可连接任何兼容 Chainweb 的节点：将 PACT_COMMUNITY_CHAINWEB_BASE_URL 指向你的 devnet，或使用只读的 testnet06 / mainnet 配置查询公共网络。

安全

两个服务都执行相同且经过测试的基线要求（详见 SECURITY.md）：

• 绝不使用私钥。 chainweb_send、chainweb_deploy_module 和 chainweb_continue_pact 要求交易在外部签名（Ledger、 @kadena/client 等），并以预签名形式传入。
• 公共网络只读。 testnet06 和 mainnet 配置会通过 PROFILE_WRITE_BLOCKED 禁用 所有写入工具。
• 审计日志记录每次工具调用的 SHA-256 输入哈希（绝不记录原始 输入）。
• 提示词注入清理会处理所有工具输出，再将其传递给模型。
• 工具架构锁定 — 如果工具架构发生变动，服务将拒绝启动。
• 网络和文件系统允许列表、禁止执行 Shell，并拒绝以 root 身份运行。

兼容性

服务	本地 devnet	测试网	主网
Pact Tooling	✅	—	—
Chainweb API	✅	✅ 只读	✅ 只读

贡献

git clone https://github.com/Pact-Community-Organization/pact-mcp.git
cd pact-mcp
pnpm install
pnpm build
pnpm test

需要 Node.js >= 20.11 和 pnpm >= 9。关于工作流、编码标准以及如何添加或修改工具，请参阅 CONTRIBUTING.md。

许可证

Apache-2.0