@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