API支付处理服务器

x402scan-mcp是一个用于调用x402保护API并自动处理支付的MCP服务器,适用于需要安全支付集成的开发者场景。

  • by Merit-Systems
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 Merit-Systems/x402scan-mcp

使用说明

x402扫描mcp

MCP呼叫服务器 x402-具有自动支付处理功能的受保护API。

安装

克劳德代码

claude mcp add x402scan --scope user -- npx -y x402scan-mcp@latest

法典

codex mcp add x402scan -- npx -y x402scan-mcp@latest

光标

克劳德桌面

Manual installation

法典 -添加到 ~/.codex/config.toml:

[mcp_servers.x402scan]
command = "npx"
args = ["-y", "x402scan-mcp@latest"]

光标 -添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "x402scan": {
      "command": "/bin/bash",
      "args": ["-c", "source $HOME/.nvm/nvm.sh 2>/dev/null; exec npx -y x402scan-mcp@latest"]
    }
  }
}

克劳德桌面 -添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "x402scan": {
      "command": "/bin/bash",
      "args": ["-c", "source $HOME/.nvm/nvm.sh 2>/dev/null; exec npx -y x402scan-mcp@latest"]
    }
  }
}

用法

第一次运行时,会生成一个钱包 ~/.x402scan-mcp/wallet.json.在拨打API付费电话之前,在Base上将USDC存入钱包地址。

工作流程:

  1. check_balance -检查钱包并获取存款地址
  2. query_endpoint -定价/模式的探测端点(可选)
  3. execute_call -提出付费请求

工具(4)

工具 说明
check_balance 获取钱包地址和USDC余额
query_endpoint 探测x402端点以获取定价/模式,无需付款
validate_payment 飞行前检查付款是否成功
execute_call 向x402端点发出付费请求

环境

变量 描述
X402_PRIVATE_KEY 覆盖钱包(可选)
X402_DEBUG 设置为 true 用于详细日志记录

支持的网络

Base、Base Sepolia、以太坊、乐观主义、Arbitrum、Polygon(通过CAIP-2)

开发

bun install

# Add local server to Claude Code
claude mcp add x402scan-dev -- bun run /path/to/x402scan-mcp/src/index.ts

# Build
bun run build

# Build .mcpb for Claude Desktop
bun run build:mcpb