内容
<!-- mcp-name: io.github.x402node/x402-mcp -->
# x402-mcp
MCP服务器，为AI代理（Claude, Cursor, 支持MCP的客户端）提供100多个x402付费API。自动从CDP Bazaar发现工具；在Base上处理USDC微支付。
## 功能
- 自动从CDP Bazaar发现x402端点（无需硬编码列表）
- 直接从Bazaar读取元数据（描述，模式，定价）
- 每5分钟刷新一次 — 新增端点无需重启
- 自动处理HTTP 402 + USDC支付
- 通过x402协议支持多链（目前为Base；未来支持Solana, Polygon, BNB, EVM扩展）
## 安装（Claude Desktop）
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": ["-y", "x402node-mcp"],
"env": { "X402_PRIVATE_KEY": "0xYOUR_BASE_PRIVATE_KEY" }
}
}
}
```
将 `X402_PRIVATE_KEY` 设置为具有USDC的Base主网EOA私钥（十六进制，0x前缀）。重启Claude Desktop。服务器在首次运行时会自动发现约117个工具。
## 成本安全
- 每次工具调用费用为$0.0001-$0.10 USDC，具体取决于端点
- 硬上限：`MAX_PRICE_USD` 环境变量（默认为$0.10/次）；超过该上限的调用将被阻止
- 请使用新的临时钱包，而不是主钱包
## 工作原理
代理调用工具 -> HTTP 402 -> x402-fetch 签署EIP-3009 -> CDP Facilitator 在Base结算 -> 返回响应。买家无需支付Gas。
## 开发
```bash
git clone https://github.com/x402node/x402-mcp
cd x402-mcp
npm install
cp .env.example .env # 编辑 X402_PRIVATE_KEY
node mcp-server.js
```
## 链接
- x402 协议： https://x402.org
- CDP Bazaar： https://docs.cdp.coinbase.com/x402/bazaar
- MCP： https://modelcontextprotocol.io
- npm： https://www.npmjs.com/package/x402node-mcp
- Glama： https://glama.ai/mcp/servers/x402node/x402-mcp
## 许可证
MIT
