Verdoc

verdoc-mcp

見たことのないリポジトリのコンテキストを、2 セントでコーディングエージェントに提供します。アカウントも API キーも不要です。

見慣れないコードベースに投入されたエージェントは、作業を始める前にコードを読む必要があります。そのたびに数万トークンがかかります。verdoc-mcp は、同じ質問に直接答える 2 つのツールを公開します。

ツール	得られるもの	価格
verdoc_agents_md	そのままコミットできる AGENTS.md	$0.02
verdoc_scan	同じ分析結果を構造化 JSON で提供	$0.01

ビルドコマンドとテストコマンドはリポジトリ独自のマニフェストから引用し、それぞれの引用元のファイル名も示します。すべてのパスを Git ツリーと照合します。曖昧な情報は推測せず、unverified として示します。

**サーバー上で言語モデルは実行されません。**同じコミットには、常に同じ回答が返ります。

インストール

最も簡単な方法は、.mcpb バンドルをダウンロードして Claude Desktop にドラッグするか、MCPB 対応クライアントから直接指定することです。依存関係はバンドルに含まれているため、別途インストールするものはありません。

npm ではまだ公開していません。このリポジトリから直接インストールする方法も 2 つあります。

{
  "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 の支払いはオフチェーンで署名され、ガス代はファシリテーターが支払います。

変数	デフォルト値	意味
EVM_PRIVATE_KEY	-	支払いに使うウォレットです。省略すると、見積もり専用モードで実行します。
VERDOC_MAX_SPEND_USD	0.05	1 回の呼び出しに対する厳格な上限です。この額を超える支払いに署名することはありません。
VERDOC_ORIGIN	https://verdoc.dev	エンドポイントを上書きします（テスト用）。

秘密鍵について

プログラムにお金を使う権限を渡すことになるため、このプログラムが行うことと行わないことを正確に説明します。

• キーは環境変数から読み込まれます。**ログに記録されず、ディスクに書き込まれず、どこにも送信されません。**キーのように見えるものは、エラーメッセージを返す前に伏せられます。
• **支払先とチェーンはソースコードで固定されています。**署名する前に、クライアントは実際の支払い要求を読み込み、内容を検証します。Verdoc が別のアドレスへの支払いを要求した場合、または許可リストにないチェーンを指定した場合、クライアントは支払いを拒否し、その旨を通知します。これにより、当社ドメインや DNS が侵害されても、資金の送金先を変更できません。
• すべての呼び出しに VERDOC_MAX_SPEND_USD の上限が適用され、署名を作成する前に確認されます。

この目的で用意したウォレットを使ってください。これは、このツールを含め、支払いを行うエージェントツール全般で推奨される方法です。

拒否する操作

以下の拒否動作は selftest.mjs でテストされています。特に確認する価値があるのは、これらの拒否動作です。

• 実際のエンドポイントから要求された場合でも、固定されたアドレス以外への支払い
• テストネットを含む、固定されたチェーンのリスト以外での支払い
• 上限を超える支払い
• 短い、または空の 200 応答を実際の回答として扱うこと

制限事項

対象は公開 GitHub リポジトリのみです。追跡対象ファイルが 20,000 個を超えるリポジトリは拒否されます。GitHub はそれを超えると Git ツリーを切り詰めるため、このサービスが示すすべての情報には、完全なツリーが必要です。

ライセンス

MIT。呼び出し先のサービスは verdoc.dev です。 OpenAPI | x402 discovery