x402score-mcp

Name: x402score-mcp
Author: zagchk

本地服务

github.com/zagchk安全02 周前更新

代码仓库

关于 x402score-mcp

x402score-mcp 是为兼容 MCP 的客户端提供 x402Score 声誉数据的 MCP 服务，供 Agent 在支付 x402 API 端点前查看评分。它通过实时探测数据并提供评分方法说明，辅助判断端点可信度。

主要功能

01查询端点评分、等级和可信区间
02搜索并排序端点排行榜
03查看评分校准报告
04提交端点进入监控队列
05检查连通性与延迟
06读取评分方法说明资源

适用场景

01付款前核查 x402 API 端点
02按领域或指标筛选受监控端点
03评估评分公式的预测能力

MCP 相关

该 MCP 服务向 MCP 客户端提供 5 个工具和 `x402score://methodology` 资源。通过 stdio 连接，可供 Claude Desktop、Claude Code 等客户端调用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "zagchk-x402score": {
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}

启动命令npx -y x402score-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402score-mcp0.4.2stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
url	string	否	端点的完整 http(s) URL。推奨——其 endpointId 在本地推导。
endpointId	string	否	如果已知，直接传入 x402Score endpointId——即 SHA-256(endpoint URL) 的前 16 个十六进制字符。

详细介绍

x402score-mcp

MCP 服务将 x402Score 的信誉数据作为 Agent 工具提供——在支付 x402 付费 API 端点之前，可通过任何兼容 MCP 的客户端（Claude Desktop、Claude Code 等）检查其信任评分。

已发布到 npm，尚未提交到任何 MCP 注册目录。 软件包本身（x402score-mcp）现在即可安装——目前暂缓的是注册目录条目（Claude、Smithery 等），直到链上修正项的校准门槛通过（约 2026-10-19）；原因请参阅主项目 README。注册目录条目内容已预先写在 REGISTRY_SUBMISSION.md 中，门槛通过后即可直接复制粘贴。最近一次已针对线上生产环境端到端重新验证（使用真实的 stdio MCP 客户端，确认全部 5 个工具和方法论资源均正常工作，包括结构化输出、错误处理和工具注释）：2026-10-10。

工具

check_endpoint_score — 查询单个端点的评分、等级和可信区间。可直接传入 url（推荐——会在本地推导 endpointId，无需单独查询），也可传入已知的 endpointId。
search_leaderboard — 按名称／域名／URL／ID 和／或垂直领域搜索或浏览受跟踪的端点；可按 score（默认）、price、uptime 或 latency 排序。
get_calibration_report — 评分公式是否确实具有预测能力？
submit_endpoint — 将新的 x402 端点添加到监控队列。
ping — 进行低成本的可达性／延迟检查，适合作为连接时的首次调用。

所有工具均声明 readOnlyHint／destructiveHint／idempotentHint／openWorldHint 注释和相匹配的 outputSchema，并且都会返回结构化错误（isError: true，附带清晰的消息；若可用，也会包含后端自身的错误文本，例如速率限制消息，而不只是 HTTP 状态），而不会因网络故障或后端超时导致连接中断。x402score://methodology 资源说明评分、等级、可信区间和链上修正项的实际含义——每个会话读取一次即可，无需仅凭工具描述推断。请求会在客户端侧 10s 后超时，因此响应缓慢或性能下降的后端会快速且明确地失败，而不会让调用方一直等待。版本历史请参阅 CHANGELOG.md。

安装与运行

npm install -g x402score-mcp
x402score-mcp

或从源代码运行：

cd mcp && npm install && npm run build
npm start

在 Claude Desktop／Claude Code 中使用

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "x402score": {
      "command": "npx",
      "args": ["-y", "x402score-mcp"]
    }
  }
}

或者像之前一样，将 command／args 指向本地的 node／dist/server.js 构建。

也可以在服务的 env 中设置 X402SCORE_BASE_URL，将其指向本地的 wrangler dev 或暂存环境部署，而不是生产环境。这会将服务的所有流量重定向到你指定的 URL，因此只应将其设为你控制并信任的后端。

开发

工具逻辑（src/tools.ts）与 MCP 协议接线（src/server.ts）分离，专门为了无需真实 MCP 传输即可测试——测试通过主项目的 vitest 运行（在仓库根目录执行：npm test）。src/server.ts 会将这些函数接入 @modelcontextprotocol/sdk 的 McpServer，并通过 stdio 建立连接。