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存入钱包地址。
工作流程：
check_balance-检查钱包并获取存款地址query_endpoint-定价/模式的探测端点（可选）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