paid-mcp-metering

按调用次数计费的 MCP 工具。

服务发现免费：POST /mcp 遵循 Model Context Protocol 规范，采用 JSON-RPC 2.0（initialize、tools/list、ping）。执行按量计费：POST /v1/t/{tool} 位于 x402 v2 付费墙之后。未付费请求会收到 HTTP 402 及支付要求；已付费请求携带 PAYMENT-SIGNATURE 请求头，并在工具运行前通过 facilitator 完成 USDC 结算。

工具

上游为 Exa（主）和 Tavily（备）。每个处理器实时返回上游输出，否则直接抛出异常——绝无预置响应。

Related MCP server: Base Intel Search

支付轨道（Rails）

x402 v2、USDC、EIP-155 网络由 X402_NETWORK 指定（默认 Base Sepolia 测试网，CAIP-2 为 eip155:84532）。Facilitator 默认为 https://x402.org/facilitator。

运行

npm install
npm run build
npm start          # node dist/x402-server.js
npm test           # build + node --test dist/test-x402.js

免费服务发现：

curl -s localhost:4021/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

付费执行：

curl -s localhost:4021/v1/t/web_search -H 'Content-Type: application/json' \
  -d '{"query":"x402 protocol","max_results":3}'
# -> 402 with payment requirements; pay via an x402 client and retry with PAYMENT-SIGNATURE

注册中心

server.json 面向官方 MCP Registry，标识为 io.github.dev55acc-ai/paid-mcp-metering。打上 v* 标签将触发 .github/workflows/publish-mcp.yml：测试、构建、npm 发布（设置了 NPM_TOKEN 时），随后通过 GitHub OIDC 认证完成注册中心发布——无需存储任何注册中心凭据。

许可证

MIT