Packetrove を AI エージェントに接続する

互換性のある MCP クライアントを接続して Packetrove のネットワークツールを利用します。以下の設定を済ませてから、ツールの例を参照してください。

Streamable HTTP · アカウントや API キーは不要

https://api.packetrove.com/mcp

クライアントを接続する

Claude Code または Codex をインストールしたら、このリモートサーバーを追加してください。以下のコマンドはクライアントを設定し、ローカルの Packetrove サーバーはインストールしません。

Claude Code

claude mcp add --transport http --scope user packetrove \
  https://api.packetrove.com/mcp
Claude Code の MCP 公式ドキュメント

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
Codex の MCP 公式ドキュメント

クライアントで /mcp を使って接続を確認します。次のツールが利用可能か確認してください:cidr-cover, cidr-subtract, range-to-cidrs, certificate-bundle, public-ip。

設定後、クライアントは tools/list でツールを検出し、説明とスキーマに基づいてツールと引数を選びます。Web ページを読むだけではクライアントの設定やアクセス権の付与は行われません。

サーバーの識別情報

サーバーはリリースバージョンとともに、以下のサービス識別情報を提供します。各ツールの名前、説明、スキーマは tools/list で個別に一覧表示されます。

{
  "name": "Packetrove",
  "title": "Packetrove",
  "description": "Open-source IP address and CIDR tools for network calculations and public IP lookup.",
  "websiteUrl": "https://packetrove.com",
  "icons": [
    {
      "src": "https://packetrove.com/packetrove-logo-32x32.png",
      "mimeType": "image/png",
      "sizes": [
        "32x32"
      ]
    }
  ],
  "version": "0.8.0"
}

タイトル、説明、Web サイト、アイコンを表示するかどうかはクライアントが決め、任意のフィールドを無視する場合もあります。プロトコルでの検出成功は、クライアントがこれらの情報を表示することを意味しません。PNG アイコンは 32×32 で、テーマの制限はありません。

任意のエージェントフィードバック

submit-feedback は任意の MCP サポート操作で、既定では無効です。tools/list に表示される場合のみ使用してください。非公開のレポートをメールで管理者に送り、人が確認します。ウェブサイト、Web API、CLI からは送信できません。

ユーザーの依頼または許可がある場合のみ送信してください。ユーザーが提供または承認した報告は直接送信できます。新しく作成した内容は先に表示して承認を得てください。会話履歴を添付したり、呼び出すたびに報告を求めたりしないでください。

submit-feedback

category は bug、confusing_behavior、feature_request です。summary は必須で、tool_name と synthetic_reproduction は任意です。bug には expected と actual、confusing_behavior には actual が必要です。feature_request は expected を指定できますが、actual と error_code は指定できません。summary は Unicode コードポイント 256 個、expected/actual は各 1024 個、再現内容は 2048 個までです。任意の error_code は大文字のコードです。未知のフィールドは拒否され、シリアライズした引数は 8 KiB 以内です。

引数の例

{
  "category": "confusing_behavior",
  "tool_name": "cidr-cover",
  "summary": "Explain why a covering CIDR can include additional addresses.",
  "actual": "The result includes addresses beyond the supplied documentation inputs.",
  "synthetic_reproduction": "Use documentation addresses 203.0.113.1 and 203.0.113.6."
}

文書用アドレスを使った結果の例

{
  "status": "accepted",
  "receipt_id": "00000000-0000-4000-8000-000000000001"
}

近似的な制限は、観測した出口 IP ごとに直近 24 時間で 10 回、サービス全体で UTC の暦日ごとに 100 回です。出口を共有するクライアントは枠も共有します。同時リクエストや KV の同期遅延により、どちらの制限も超える場合があります。送信結果が不明な場合や枠の解放に失敗した場合は、期限まで枠を使います。計算や照会には影響しません。

accepted と receipt_id はメールサービスが送信を受け付けたことを示し、受信トレイへの到着や閲覧は保証しません。返信や修正も約束しません。明確な拒否では delivery: not_accepted を返します。タイムアウト、キャンセル、DELIVERY_UNCERTAIN の後に自動再送しないでください。レポートがすでにメールで送信された可能性があります。重複排除は行いません。

有効な場合、submit-feedback は承認されたレポート、受領番号、サービスの公開バージョン、送信時刻を Cloudflare 経由で管理者のメールに送り、人が確認します。架空の例を使い、実際のネットワークデータ、証明書、秘密、ログ、会話履歴を含めないでください。メールの保管と削除は手動で管理し、レポートは自動的に期限切れになりません。Cloudflare Workers KV は鍵付きの出口 IP マーカーと予約時刻だけを別に保存し、24 時間で期限切れになります。レポート本文や受領番号との関連は保存しません。マーカーはレポートにもログにも含めません。メールを削除しても枠は戻りません。削除依頼は受領番号を添えて管理者にメールしてください。レポートは自動公開しません。

プライバシーポリシー

結果の読み取りとエラー処理

structuredContent またはテキストブロックの JSON を読み取ってください。アドレス数は十進数の文字列か任意精度整数として保持してください。大きな IPv6 の値を浮動小数点数に変換すると精度が失われます。

計算と照会に成功した応答は structuredContent と最初の JSON テキストブロックに結果を保持し、英語のツールページへの任意の resource_link を追加します。リンクには入力や結果を含めず、計算内容を復元しません。表示、無視、リンクを開くかどうかはクライアントが決定し、自動表示や引用は保証されません。公開 IP ページを開くとブラウザの新しい接続を確認するため、MCP クライアントの接続とは異なる場合があります。エラー応答にツールページリンクは含まれません。

isError が true の場合は再試行前にエラー JSON を確認してください。ユーザーの情報で INVALID_INPUT と MIXED_ADDRESS_FAMILIES を修正します。CLIENT_IP_UNAVAILABLE は信頼できる接続情報がないことを示すため、アドレスを推測しないでください。

業務エラーは共通のエラー JSON を返します。MCP SDK がプロトコルを検証します。不正な JSON、未対応のメディア形式、過大な本文は HTTP 層で拒否されます。

Node.js の例を実行する

新しいディレクトリで、下のコードを packetrove-example.mjs として保存し、コマンドを実行します。例は @modelcontextprotocol/client@2.0.0 を使い、ツールを検出して文書用アドレスで CIDR ツールを呼び出します。

import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';

const client = new Client(
  { name: 'packetrove-example', version: "0.8.0" },
  { versionNegotiation: { mode: 'auto' } },
);
try {
  await client.connect(new StreamableHTTPClientTransport(new URL("https://api.packetrove.com/mcp")));
  const serverInfo = client.getServerVersion();
  const { tools } = await client.listTools();
  const result = await client.callTool({
    name: "cidr-cover",
    arguments: {"inputs":["203.0.113.1","203.0.113.2","203.0.113.6"]},
  });
  if (result.isError) throw new Error(JSON.stringify(result.content));
  console.log(serverInfo, tools.map(tool => tool.name), result.structuredContent);
  const links = result.content?.filter(content => content.type === 'resource_link') ?? [];
  console.log(links); // Optional links; opening or presenting them is the client's choice.
} finally {
  await client.close();
}
npm init -y
npm install @modelcontextprotocol/client@2.0.0
node packetrove-example.mjs

ローカル開発では pnpm dev:api を起動し、例のサーバー URL を http://localhost:8787/mcp に置き換えてください。

デプロイと接続の制限

サーバーは新しいステートレス要求と、従来の Streamable HTTP の初期化、検出、呼び出しに対応します。永続セッションや独立したサーバーイベントストリームは提供しません。

公開 IP の接続情報は呼び出しごとに読み取られ、同時接続するクライアントのサーバーインスタンスは分離されます。MCP の結果とエラーは Cache-Control: no-store, no-transform を使用します。アプリは照会アドレスを保存・記録しません。

ツール名、成功またはエラー、管理されたエラーコード、呼び出し元の分類を含む運用イベントで実行回数を集計します。検証済みの自動チェックでは実行識別子も記録する場合があります。入力、結果、取得したアドレス、生のリクエストヘッダー、自動チェック用トークンは含めません。Cloudflare がリクエストのメタデータを追加する場合があります。データ処理と保持期間はプライバシーポリシーをご確認ください。

旧ツール名に互換エイリアスはありません:smallest_covering_cidr → cidr-cover, subtract_cidrs → cidr-subtract, get_public_ip → public-ip。ツール検出と保存済みの呼び出しを更新してください。

ウェブサイトの /mcp はサービスではなく、GET は 404、POST は 405 を返し、呼び出しを転送しません。クライアントには https://api.packetrove.com/mcp を設定してください。独自デプロイではドメインと、Host およびブラウザー Origin の個別の完全一致許可リストを更新します。Origin ヘッダーのないクライアントも対応します。

デプロイ、セルフホスティング、本番確認プライバシーポリシーMCP Registry への公開とバージョン方針リポジトリの MCP 技術ガイドを読む(英語)