basezap-mcp

一个MCP（模型上下文协议）服务器，将BaseZap的打赏代理工具暴露给任何MCP客户端——Claude Desktop、Cursor、Claude Code等。

该服务器设计为只读/非托管：它从不持有私钥，从不签署任何内容，也从不广播交易。它仅获取平台信息、计算费用报价，并为单独的连接钱包的客户端构建未签名的ERC-20转账调用数据，供其签名和发送。

工具

• get_platform_info — 链、USDC地址、平台费用（基点）、费用钱包。

• get_tip_quote — 给定USDC金额，返回精确的创作者/平台费用分配。

• build_tip_calldata — 给定接收者地址+金额，返回打赏两部分的未签名调用数据。从不签署或发送任何内容。

• resolve_farcaster_username — 将Farcaster用户名解析为其已验证的钱包地址（直接使用BaseZap的/api/resolve-user端点）。

Related MCP server: x402-bazaar-mcp

安装

npm install --ignore-scripts
npm run build

（--ignore-scripts可避免某些环境（如Termux/Android）中的原生模块构建问题——在任何地方使用都无害。）

独立运行（用于测试）

npm start

或者直接通过stdio测试单个工具调用，无需任何MCP客户端：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_tip_quote","arguments":{"amountUsdc":1}}}' | node build/index.js

Claude Desktop配置

将此添加到您的claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "basezap": {
      "command": "node",
      "args": ["/absolute/path/to/basezap-mcp/build/index.js"],
      "env": {
        "BASEZAP_USE_X402": "false"
      }
    }
  }
}

将路径替换为您机器上build/index.js的真实绝对路径。编辑配置后重启Claude Desktop。

免费与付费（x402）模式

默认情况下（BASEZAP_USE_X402=false或未设置），服务器调用BaseZap的免费端点（/api/agent）。设置BASEZAP_USE_X402=true可将调用路由到付费的x402端点（每次调用0.001 USDC）。

重要提示：仅设置BASEZAP_USE_X402=true并不会让服务器自动付费——除非您已单独设置自动支付（见下文），或者正在使用已为您处理x402支付的MCP客户端/网关，否则每次调用都会收到明确的HTTP 402 Payment Required错误。

可选：x402自动支付

请参阅AUTOPAY.md，了解如何从头开始让此服务器使用已充值的钱包自动支付其x402费用。在使用前请仔细阅读——这涉及将真实的私钥放入环境变量中，配置错误的自动支付服务器可能会在每次工具调用时静默消耗真实资金。默认情况下未启用，您应在启用前确切了解其作用。

已验证的请求合约

此服务器依赖的确切请求/响应形状已针对真实的/api/agent端点进行了实时确认（而非根据文档假设）：

{ "tool": "get_tip_quote", "args": { "amount_usdc": 1 } }

返回：

{ "total_usdc": 1, "creator_receives_usdc": 0.95, "platform_fee_usdc": 0.05, "platform_fee_bps": 500 }

注意API本身在args内部使用snake_case字段名——此服务器的MCP工具输入使用友好的camelCase（amountUsdc）并在内部转换，因此仅当您修改服务器本身时才相关。