@chainpayto/mcp-server

ChainPay MCP Server — 让 AI Agent 直接操作 ChainPay 加密货币收款系统。

支持 Claude Desktop、Cursor、Dify、Coze 等任何兼容 Model Context Protocol 的 AI 平台。

功能

工具	说明
chainpay_get_supported_chains	查询支持的链和代币（含费率、最低金额）
chainpay_create_order	创建支付订单，获取收款地址和支付链接
chainpay_get_order	查询指定订单详情和状态
chainpay_list_orders	分页查询订单列表
chainpay_get_balance	查询商户账户余额
chainpay_create_withdrawal	发起提现申请

快速配置

获取 API 凭证

1. 登录 ChainPay 商户后台
2. 进入 API Keys 页面，创建一个 API Key
3. 复制 API Key 和 API Secret 明文（Secret 只显示一次，请妥善保存）
4. 直接把明文填入下面的 CHAINPAY_API_SECRET，不要再做 SHA256 哈希

⚠️ 升级提示：早期版本要求提前 sha256sum 处理 Secret，现已废弃。当前后端用明文 HMAC-SHA256 签名，Secret 明文保存在后台数据库。如果你之前用哈希版配好了，需要到后台 重置 API Key，用新 Secret 明文重新填入环境变量。

---

Claude Desktop

编辑 ~/.config/claude/claude_desktop_config.json（macOS/Linux）
或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "chainpay": {
      "command": "npx",
      "args": ["-y", "@chainpayto/mcp-server"],
      "env": {
        "CHAINPAY_API_URL": "https://api.chainpay.to",
        "CHAINPAY_API_KEY": "your_api_key",
        "CHAINPAY_API_SECRET": "your_api_secret_plaintext"
      }
    }
  }
}

---

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "chainpay": {
      "command": "npx",
      "args": ["-y", "@chainpayto/mcp-server"],
      "env": {
        "CHAINPAY_API_KEY": "your_api_key",
        "CHAINPAY_API_SECRET": "your_api_secret_plaintext"
      }
    }
  }
}

---

全局安装（可选）

如果不想每次都用 npx，可以全局安装：

npm install -g @chainpayto/mcp-server

安装后配置中将 "command": "npx", "args": ["-y", "@chainpayto/mcp-server"] 改为：

{
  "command": "chainpay-mcp",
  "args": []
}

---

环境变量

变量名	必填	说明	默认值
CHAINPAY_API_KEY	✅	商户 API Key	—
CHAINPAY_API_SECRET	✅	API Secret 明文（不是哈希）	—
CHAINPAY_API_URL	可选	API 地址（私有部署时修改）	https://api.chainpay.to

---

使用示例

配置完成后，在 AI 对话中直接说：

"帮我创建一个 50 USDT 的 TRON 链支付订单，订单号 ORDER-001"

"查询一下 CP20260418163248523136 订单的状态"

"我的账户余额是多少？"

"帮我把 100 USDT (BSC) 提现到绑定的地址"

---

技术要求

• Node.js >= 18
• 无其他系统依赖，npx 自动处理

链接

• ChainPay 官网
• API 文档
• 费率说明
• 商户注册

License

MIT