MCP 服务器

@chainpayto/mcp-server

Enables AI agents to directly operate ChainPay cryptocurrency payment system, including order creation, balance checks, and withdrawals.

README

@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 凭证

登录 ChainPay 商户后台
进入 API Keys 页面，创建一个 API Key
复制 API Key 和 API Secret 明文（Secret 只显示一次，请妥善保存）
直接把明文填入下面的 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`