Verdoc

verdoc-mcp

让你的编码 Agent 了解一个从未见过的代码仓库，只需花两分钱，无需账户或 API 密钥。

Agent 进入陌生的代码库后，必须先阅读代码才能开始工作——每次都要耗费数万个 token。verdoc-mcp 提供了两个工具，可直接回答同样的问题：

工具	可获得的内容	价格
verdoc_agents_md	可直接提交的 AGENTS.md	$0.02
verdoc_scan	以结构化 JSON 呈现的相同分析结果	$0.01

构建和测试命令直接引用自仓库自身的清单文件，并注明每条命令的来源文件。每条路径都会与 git 树核对。任何有歧义的内容都会标记为 unverified，而不是猜测。

服务端不会运行任何大模型。 同一个提交始终会返回相同的答案。

安装

最简单的方式：下载 .mcpb bundle，然后将其拖入 Claude Desktop，或者让任何兼容 MCPB 的客户端直接使用它——依赖项已打包在内，无需单独安装。

目前尚未发布到 npm。还可以通过以下两种方式直接从此仓库安装：

{
  "mcpServers": {
    "verdoc": {
      "command": "npx",
      "args": ["-y", "github:verdochello/verdoc-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

或者克隆仓库，并直接指向对应文件：

git clone https://github.com/verdochello/verdoc-mcp && cd verdoc-mcp && npm install

{
  "mcpServers": {
    "verdoc": {
      "command": "node",
      "args": ["/absolute/path/to/verdoc-mcp/index.mjs"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

兼容 Claude Desktop、Claude Code、Cursor 及任何 MCP 客户端。

没有密钥也能运行。 工具会报告费用及其会返回的内容，但不会购买任何东西。这正是推荐的试用方式。

付款

钱包需要持有 Base、Polygon 或 Arbitrum 上的 USDC。不需要 ETH——x402 付款采用链下签名，由支付中介支付 Gas。

变量	默认值	说明
EVM_PRIVATE_KEY	-	用于付款的钱包。不设置则以仅报价模式运行。
VERDOC_MAX_SPEND_USD	0.05	单次调用的硬性上限。超过此金额的款项绝不会被签名。
VERDOC_ORIGIN	https://verdoc.dev	覆盖端点（用于测试）。

关于私钥

你将把花费资金的能力交给一个程序，因此下面会明确说明这个程序会做什么、不会做什么。

• 密钥从环境变量中读取。它绝不会被记录、写入磁盘或发送到任何地方。返回错误消息前，会清除所有看起来像密钥的内容。
• 收款方和链都固定在源代码中。 在签署任何内容前，客户端会读取实时付款报价并进行核验。如果 Verdoc 要求将款项支付到其他地址，或支付到列表之外的链上，客户端就会拒绝付款并告知你。这意味着，即使我们的域名或 DNS 遭到入侵，也无法转移你的资金。
• 每次调用的金额上限均由 VERDOC_MAX_SPEND_USD 限定，并会在生成签名之前进行检查。

请使用专门为此用途注资的钱包。这是使用任何需要付款的 Agent 工具时都应遵守的良好做法，包括本工具。

本工具会拒绝的操作

这些拒绝行为均在 selftest.mjs 中经过测试，值得重点了解的正是这些拒绝行为：

• 向固定地址以外的地址付款——即使实时端点提出了这样的要求
• 向固定范围之外的链付款，包括测试网
• 支付超过你设定上限的金额
• 将过短或为空的 200 响应视为有效答案

限制

仅支持公开的 GitHub 仓库。跟踪文件数超过 20,000 的仓库将被拒绝：GitHub 会截断超过此数量的 git 树，而本服务的所有结论都依赖完整的树。

许可证

MIT。所调用的服务位于 verdoc.dev—— OpenAPI | x402 发现文档