x402-mcp-server

x402-mcp-server

通过 x402 微支付，在 Base 主网上提供一组规模较小、不断扩充的 x402 付费墙 HTTP 工具目录——无需 API 密钥或注册，按次使用并以 USDC 付款。

此 MCP 服务将该目录作为原生 MCP 工具提供。每次工具调用都会自动完成付款：服务会发送 POST 请求，捕获真实的 x402 v2 402 PAYMENT-REQUIRED 挑战，使用本地钱包通过 viem 签署 EIP-3009 TransferWithAuthorization，然后在请求中加入 PAYMENT-SIGNATURE 标头重新提交。调用时无需人工签名确认——Agent 只需调用工具即可。

工具

工具	费用（USDC）	说明	关键输入参数
markdown-extractor	0.01	获取公开 URL，并返回简洁、节省令牌的 Markdown；通过 Base 主网上的 x402 v2 协议设置付费墙。专为自主 AI Agent 直接调用而设计：无需 API 密钥或注册，按次使用并以 USDC 付款。	url（字符串，必填）
spa-dom-to-md	0.03	通过 Cloudflare Browser Rendering，在真实的无头 Chromium 中渲染 JavaScript 密集型 SPA 页面，等待网络空闲或选择器就绪，移除导航栏、页脚和脚本等界面内容，并将完整渲染后的 DOM 序列化为简洁、适合大模型的 Markdown。	url（字符串，必填）
burn-once-secret-vault	0.01	使用 WebCrypto AES-256-GCM 加密存储机密（API 密钥、Webhook 负载、签名 URL），并分享一个只能领取一次机密的 URL。Durable Object 会对读取操作进行串行处理，确保单次交付不会发生竞争；每次机密销毁操作都会返回 Ed25519 签名的证明。创建保险库需要支付 x402 费用；接收者免费领取机密（GET /v/:vault_id）。	secret（字符串，必填）
svg-bar-chart-renderer	0.015	面向大模型 Agent 的确定性按次付费 SVG 柱状图生成器。接收带标签的标量数据和布局选项，执行精确的几何计算（最小值／最大值归一化、合适间隔的 y 轴刻度、标签间距、柱宽分布），并返回符合架构且转义正确的 SVG；相同输入始终产生逐字节相同的输出。	data（数组，必填）
wasm-geotiff-transcoder	0.03	解码 GeoTIFF/COG（HTTPS URL 或内嵌 base64），通过分块概览读取所选 RGB 波段，应用色调映射拉伸，并返回 PNG/WebP 和地理参考元数据（CRS、边界、像素比例）及源数据统计信息。限制：源文件最大 20 MB，输出宽度最大 2048 px。按尝试次数计费：结构验证通过后、开始解码前即结算，因此解码时失败（例如源文件缺少 bands_rgb 中指定的波段）仍会收费。	source 或 or_base64_body（必须且只能提供其中一个）

所有工具均运行在 Base 主网（eip155:8453）。结算由服务端通过有序的促进服务链完成——Coinbase CDP，然后是 PayAI，最后是备用的 Primer——这不会改变你这边的任何操作：无论使用哪个促进服务，你都签署相同的 EIP-3009 授权；而且所有工具也都列在 CDP 和 PayAI 的 x402 Bazaar 发现目录中。每个工具的准确请求正文字段也可在运行时通过 <tool-url>/openapi.json 查找。

快速开始

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

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server_by_milza"],
      "env": {
        "BASE_PRIVATE_KEY": "0xyour_base_mainnet_private_key"
      }
    }
  }
}

⚠️ 资金警告：BASE_PRIVATE_KEY 必须是已注入少量真实 USDC 的 Base 主网钱包私钥（例如，$0.50 足以按当前价格支付数十次调用）。每次工具调用都会从此钱包中支出真实资金。请勿使用存有你不打算通过此服务支出的资金的钱包密钥，也绝不要将此密钥提交到源代码管理中。

完成配置后，重启 Claude Desktop，上述工具便会自动提供给助手使用——无需其他设置、控制面板或 API 密钥注册。

支付如何运作

BASE_PRIVATE_KEY 是你自己的钱包——安装此服务的每个人都会设置自己的密钥，并为自己的调用付费。每次调用都会直接结算到工具提供方的钱包；你的密钥不会接触任何其他人的资金，其他人的密钥也不会接触你的资金。设置方法如下：

1. 使用（或创建）一个你愿意用来支付少量费用的 Base Mainnet EVM 钱包。
2. 向其中存入少量 Base 上的 USDC（例如 0.50 美元）。
3. 导出其私钥，并按照上文所示，在 MCP 客户端配置中将其设置为 BASE_PRIVATE_KEY。

安全性

• BASE_PRIVATE_KEY 不会离开你的设备。它只会从本地环境中读取一次，并且仅用于在本地通过 viem 对 EIP-712 类型化数据（EIP-3009 TransferWithAuthorization）支付授权进行签名。
• 原始私钥、助记词或签名绝不会通过网络发送——只会发送生成的已签名授权，这正是 x402 协议为结算当前请求的付款所要求的内容。
• 支付条款（接收方、金额、网络、资产合约、到期时间）会从资源服务返回的每个实时 402 挑战中重新读取，不会信任本地缓存，因此过期或被篡改的本地目录无法重定向资金。
• 支出上限：实时 402 挑战仅用于确定签名机制（域、随机数窗口、资产），但不会用于确定金额。每次调用都会将挑战请求的金额与此目录中该工具的已知价格进行核对，并拒绝签署任何超出价格的金额——劫持、遭入侵或存在错误的端点，无法仅靠索要更多金额就获得一份空白支票式签名。
• 此软件包不会向开发者发送数据、收集遥测信息，也不会在磁盘上的任何位置存储你的密钥。

要求

• Node.js 18+
• 一个已存入少量 USDC、且私钥由你掌控的 Base Mainnet EVM 钱包

许可证

MIT

链接

• npm 软件包
• 源代码／问题反馈