@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

Pay 的 MCP 服务器 —— 专为 AI 代理打造的完整 x402 支付栈。基于 Base 链上的 USDC。

为任何兼容 MCP 的客户端（Claude Desktop、Cursor、VS Code、自定义框架）提供 Pay 的全部功能：直接支付、标签页、x402 支付墙、服务发现和钱包管理。无需 CLI 二进制文件。

设置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

添加到 .vscode/mcp.json：

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

设置完成。首次运行时，服务器会生成一个钱包并将其存储在操作系统钥匙串中（Windows Hello、macOS Keychain、Linux Secret Service）。后续运行将自动加载。

配置

环境变量	必需	默认值	描述
`PAYSKILL_SIGNER_KEY`	否	—	可选覆盖。原始十六进制密钥或 `.enc` 密钥库密码。正常使用无需设置。
`PAY_NETWORK`	否	`mainnet`	`mainnet` (Base) 或 `testnet` (Base Sepolia)

密钥解析（按顺序检查）

操作系统钥匙串（默认）— 通过 keytar 从操作系统凭据存储中加载。首次运行时，会自动生成并存储新的密钥对。
加密密钥库 — 如果存在 ~/.pay/keys/default.enc，则使用 PAYSKILL_SIGNER_KEY 作为解密密码。
原始十六进制密钥 — 如果 PAYSKILL_SIGNER_KEY 是 64 字符的十六进制字符串，则直接使用。用于开发/测试或导入现有钱包。
自动生成 — 如果以上都不存在，则生成新的密钥对并存储在操作系统钥匙串中。

诊断检查

验证所有配置是否正确：

npx @pay-skill/mcp --check

输出：

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

工具 (15)

支付

工具	描述
`pay_send`	直接 USDC 支付（最低 $1）。确认阈值：<$10 自动， $10-100 计划， >$100 明确确认。
`pay_request`	带有 x402 自动支付的 HTTP 请求。处理 402 检测、直接/标签页结算、价格质疑。

标签页（计量账户）

工具	描述
`pay_tab_open`	打开预付标签页（最低 $5，建议 $50）。提供商按调用次数收费。
`pay_tab_close`	关闭标签页。返回分配明细（提供商 99%，费用 1%，代理剩余）。
`pay_tab_charge`	针对打开的标签页扣费（仅限提供商）。
`pay_tab_topup`	为打开的标签页充值（仅限代理）。
`pay_tab_list`	列出带有空闲/余额不足标记的标签页。

钱包

工具	描述
`pay_status`	余额、锁定/可用资金、可操作建议。
`pay_fund`	生成 1 小时有效的充值链接（Coinbase Onramp 或直接 USDC）。
`pay_withdraw`	生成 1 小时有效的提现链接。
`pay_mint`	铸造测试网 USDC（仅限 Base Sepolia）。

发现与 Webhook

工具	描述
`pay_discover`	按关键词/类别搜索付费 API 服务。
`pay_webhook_register`	注册支付事件的 Webhook（HMAC 签名）。
`pay_webhook_list`	列出已注册的 Webhook。
`pay_webhook_delete`	删除 Webhook。

资源 (5)

URI	描述
`pay://wallet/status`	余额、标签页、锁定/可用资金
`pay://wallet/tabs`	所有打开的标签页
`pay://tab/{tab_id}`	单个标签页详情
`pay://wallet/address`	钱包地址
`pay://network`	网络配置 + 合约地址

提示词 (3)

提示词	描述
`pay-for-service`	引导式：发现服务、评估定价、发起请求
`review-tabs`	审查标签页、标记空闲、建议关闭/充值
`fund-wallet`	生成充值链接、解释存款流程

开发

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_SIGNER_KEY)

许可证

MIT

Pay 的一部分

Pay 是完整的 x402 支付栈 —— 包括网关、促进器、SDK、CLI 和 MCP 服务器 —— 让 AI 代理能够使用 Base 链上的 USDC 支付 API 费用。

文档
架构
SDK -- Python + TypeScript
CLI -- 命令行工具
pay-gate -- x402 支付网关
协议 -- 智能合约

pay-mcp