Paid MCP Metering

Name: Paid MCP Metering
Author: dev55acc-ai

远程服务

github.com搜索与检索09 周前更新

代码仓库访问官网

关于 Paid MCP Metering

Paid MCP Metering 是一个按工具调用计费的 MCP 服务，免费开放工具发现，并通过 x402 v2 对执行请求收费。它提供实时网页搜索和多来源深度研究；当前部署尚未配置收款地址，因此付费执行暂不可用。

主要功能

01免费 MCP 工具发现
02按次计费的工具执行
03实时网页搜索
04带来源引用的综合研究
05x402 v2 USDC 结算机制

适用场景

01发现可用的搜索与研究工具
02为应用添加按次计费的网页搜索
03生成带来源的多来源研究结果
04部署时配置收款地址以启用结算

MCP 相关

通过 MCP JSON-RPC 提供免费的初始化和工具列表发现；工具执行位于按次付费的 HTTP 端点后，并使用 x402 v2 结算。当前线上部署未配置收款地址，执行返回 503。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp

一键复制安装命令

Claude CodeTerminal

claude mcp add --transport http dev55acc-ai-paid-mcp-metering https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp

Cursor.cursor/mcp.json

{"mcpServers":{"dev55acc-ai-paid-mcp-metering":{"type":"http","url":"https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"}}}

在 Cursor 中打开

VS Code.vscode/mcp.json

{"servers":{"dev55acc-ai-paid-mcp-metering":{"type":"http","url":"https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"}}}

在 VS Code 中打开

Claude Desktopclaude_desktop_config.json

{"mcpServers":{"dev55acc-ai-paid-mcp-metering":{"type":"http","url":"https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json

{"mcpServers":{"dev55acc-ai-paid-mcp-metering":{"serverUrl":"https://paid-mcp-metering-clsiojdd7-benlafreniere6-3913s-projects.vercel.app/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

按次计费的 MCP 工具

按调用次数计费的 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。

在线部署

基础 URL：https://paid-mcp-metering.vercel.app

GET /health — 免费，公开
POST /mcp — 免费发现
POST /v1/t/{tool} — 按次计费；当前返回 503 settlement_not_configured，因为部署未设置 X402_PAY_TO（/health 中的 settlementConfigured:false 是如实反映此状态的开关）。配置收款地址之前无法接受任何付款。

server.json 将此 URL 声明为注册表远程服务。

工具

工具	价格	返回内容
`web_search`	$0.001/次调用	按相关性排序的实时网络搜索结果，附来源 URL
`deep_research`	$0.01/次调用	多来源研究结果，包含综合答案和引用来源

上游服务为 Exa（主要）和 Tavily（备用）。每个处理程序都会返回实时上游输出，或抛出异常——不会返回预设响应。

支付机制

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

环境变量	用途
`X402_PAY_TO`	收款地址。结算必需；未设置时仅提供 402 付款要求
`X402_NETWORK`	CAIP-2 网络 ID（默认为 `eip155:84532`）
`X402_FACILITATOR_URL`	x402 facilitator 端点
`EXA_API_KEY` / `TAVILY_API_KEY`	上游搜索服务凭据

运行

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 注册表中的项目标识为 io.github.dev55acc-ai/paid-mcp-metering。为 v* 创建标签会运行 .github/workflows/publish-mcp.yml：测试、构建、发布到 npm（设置了 NPM_TOKEN 时），然后通过 GitHub OIDC 进行注册表发布——无需存储注册表凭据。