mcpField
X
X402 Mcp

X402 Mcp

本地服务
github.com/x402node金融数据115 周前更新
代码仓库

关于 X402 Mcp

X402 Mcp 通过 MCP 向 AI Agent 提供需付费的 x402 API。它从 CDP Bazaar 发现端点并定期刷新元数据，还可在 Base 和 Solana 上处理 USDC 支付。

主要功能

  1. 01从 CDP Bazaar 发现端点
  2. 02读取端点元数据和定价
  3. 03每五分钟刷新端点
  4. 04自动处理 HTTP 402 支付
  5. 05支持 Base 和 Solana 上的 USDC

适用场景

  1. 01查找新上架的 x402 API 工具
  2. 02自动支付 USDC 并调用付费 API
  3. 03通过价格上限控制单次支出

MCP 相关

它将发现的 x402 付费 API 作为工具提供给 MCP 客户端，并处理 HTTP 402 支付流程后返回 API 响应。

#x402#payment#discovery#coinbase#agent#utilities#chinese-culture#ocr#translation#wallet

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "x402-mcp-x402node": {
      "command": "npx",
      "args": [
        "-y",
        "x402node-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
启动命令npx -y x402node-mcp
需要配置的环境变量
X402_PRIVATE_KEY密钥Base EOA private key (hex, 0x-prefixed) with USDC for signing x402 payments

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmx402node-mcp1.0.4

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

x402-mcp

将数百个由 x402 付费的 API 接入 AI Agent 的 MCP 服务（Claude、Cursor、兼容 MCP 的客户端）。自动从 CDP Bazaar 发现工具；在 Base 和 Solana 上处理 USDC 微支付。

功能

  • 自动从 CDP Bazaar 发现 x402 端点（无需硬编码列表）
  • 直接从 Bazaar 读取元数据（描述、架构、定价）
  • 每 5 分钟刷新一次——无需重启即可发现新端点
  • 自动处理 HTTP 402 和 USDC 付款
  • 多链支持：Base 和 Solana 主网已上线（两者均支持 USDC）；可扩展至 Polygon/BNB/EVM

安装（Claude Desktop）

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": ["-y", "x402node-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_BASE_PRIVATE_KEY" }
    }
  }
}

将 X402_PRIVATE_KEY 设置为持有 Base 主网 USDC 的 Base EOA 私钥（十六进制，以 0x 开头；也支持通过 SPL USDC 在 Solana 上付款）。重启 Claude Desktop。服务首次运行时会自动发现约 117 个工具。

费用安全

  • 每次工具调用的费用为 $0.0001-$0.10 USDC，具体取决于端点
  • 设有硬性上限：MAX_PRICE_USD 环境变量（默认每次调用 $0.10）；超过上限的调用会被拦截
  • 使用新的临时钱包，不要使用主钱包

工作原理

Agent 调用工具 -> HTTP 402 -> x402-fetch 签署 EIP-3009 -> CDP Facilitator 在 Base 或 Solana 上结算 -> 返回响应。买方无需支付 Gas。

开发

git clone https://github.com/x402node/x402-mcp
cd x402-mcp
npm install
cp .env.example .env  # edit X402_PRIVATE_KEY
node mcp-server.js

链接

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。