ipvolt proxy toolkit MCP Server認証済み注目

ipvolt Proxy Toolkit MCP とは？

ipvolt Proxy Toolkit MCP は、レビュー済みのプロキシドキュメント、テスト済みのプロキシ設定テンプレート、プロキシエラーの構造化された診断を AI エージェントに提供するオープンソースの MCP サーバーです。API キーもプロキシアカウントも不要です。

プロキシ事業者の ipvolt が MIT ライセンスで公開しています。このツールキットは、まだ提供が始まっていない ipvolt の商用プロキシサービスとは別物です。プロキシの払い出し、トラフィックの購入、アカウントデータの参照、他のエージェントのネットワーク経路の変更は行いません。4 つの公開ツールは、同梱されたバージョン付きの ipvolt 公開ガイドのカタログに対して動作するため、ローカルサーバーはネットワークリクエストを行わず、テレメトリも送信しません。

ipvolt Proxy Toolkit MCP の使い方

実行方法は npm パッケージ、ソースからのビルド、ホスト型エンドポイントの 3 つです。

npm パッケージ

バージョン 0.1.0 が @ipvolt/proxy-toolkit-mcp として公開されています。README ではバージョンの固定を推奨しています：

{
  "mcpServers": {
    "ipvolt": {
      "command": "npx",
      "args": ["--yes", "@ipvolt/proxy-toolkit-mcp@0.1.0"]
    }
  }
}

ソースからビルド

Node.js 24 以上と npm が必要です。リポジトリのディレクトリで実行します：

npm ci
npm run build
npm run check:content
node dist/transports/stdio.js --version

次に、コンパイル済みのエントリを絶対パスでクライアントに指定します：

{
  "mcpServers": {
    "ipvolt": {
      "command": "node",
      "args": ["/absolute/path/to/proxy-toolkit-mcp/dist/transports/stdio.js"]
    }
  }
}

同じ mcpServers ブロックは Claude Desktop（claude_desktop_config.json）と Cursor（~/.cursor/mcp.json）で使えます。Claude Code の場合：

claude mcp add ipvolt -- npx --yes @ipvolt/proxy-toolkit-mcp@0.1.0

ホスト型エンドポイント

公開 URL は https://mcp.ipvolt.com/mcp（Streamable HTTP）です。登録も API キーも不要で、4 つの公開ツールを提供します。

claude mcp add --transport http ipvolt https://mcp.ipvolt.com/mcp

Claude Desktop または claude.ai では、この URL でカスタムコネクタを追加します。Cursor または VS Code では url エントリを追加します：

{
  "mcpServers": {
    "ipvolt": {
      "url": "https://mcp.ipvolt.com/mcp"
    }
  }
}

（VS Code では servers キーと "type": "http" を使います。）ホスト型サービスはローカルの経路診断を拒否し、プロキシ設定も受け付けません。

ipvolt Proxy Toolkit MCP の主な機能

• レビュー済みのプロキシガイドを検索・閲覧し、正規リンク、抜粋、コンテンツのリビジョンを返します。
• curl 8.22.0、Requests 2.34.2、HTTPX 0.28.1、Playwright 1.63.0 向けのバージョン固定のリクエストテンプレート。いずれも管理された認証付きプロキシでテスト済みです。
• テンプレートは HTTP プロキシと HTTPS CONNECT を使い、宛先の TLS を検証し、リダイレクトと自動リトライを無効にし、宛先とプロキシをローカルの TARGET_URL と PROXY_URL 変数に保持します。
• 不確かさとリトライの範囲を明示する構造化されたエラー診断。
• 明示的に有効化するオプションのローカル経路チェック。
• ローカルサーバーはテレメトリを送りません。ホスト側の指標はツール名、ステータス、所要時間、バージョンだけを記録します。

ipvolt Proxy Toolkit MCP のツール

• ドキュメント：search_proxy_docs はレビュー済みのガイドと記事を検索します。get_proxy_doc は指定したドキュメントやセクションを上限付きのチャンクで返し、リビジョンに紐づく継続カーソルを付けます。
• 設定：generate_proxy_config はローカル環境変数のプレースホルダー付きで、バージョン固定の HTTPS GET テンプレートを返します。コードは実行しません。
• 診断：diagnose_proxy_error は CONNECT 407、TLS 失敗、原因の曖昧なタイムアウトなどの構造化された観測を解釈します。
• 経路チェック（ローカルのみ）：check_proxy_route は設定済みのプロキシ経由で、固定のエコーエンドポイント https://mcp.ipvolt.com/egress に上限付きのリクエストを 1 回送ります。既定では無効です。

README の引数例：検索は {"query":"curl proxy","topic":"setup"}、診断は {"client":"httpx","version":"0.28.1","phase":"proxy_connect","status":407}。

ipvolt Proxy Toolkit MCP のユースケース

• クライアントの設定：「HTTP プロキシ経由で通信する、テスト済みの HTTPX 0.28.1 の例を見せて」
• 障害のデバッグ：「プロキシ経由の curl リクエストが CONNECT で 407 を返す。何が原因と考えられる？」
• ガイドの検索：「curl でプロキシを設定する ipvolt のガイドを探して」
• 出口の確認：経路チェックを有効にして、1 回のリクエストがどの出口アドレスから出るかを確認する。

ipvolt Proxy Toolkit MCP のトラブルシューティング

• check_proxy_route が表示されない：IPVOLT_ENABLE_ROUTE_CHECK=1 を設定し、クライアントのローカル環境で IPVOLT_PROXY_URL を渡してから、{"profile":"default"} で呼び出してください。ホスト型サーバーでは使えません。
• 407 の診断で原因が特定されない：仕様です。407 はプロキシ認証を示しますが、パスワード、アカウントの状態、アクセスポリシーのどれが原因かまでは分かりません。
• ビルドに失敗する：ソースからのビルドには Node.js 24 以上が必要です。
• ホスト型の呼び出しが制限される：既定では 1 アドレスあたり毎分 120 リクエスト、リクエスト本文は 32 KiB までです。