PacketStream

PacketStream MCP サーバー：AI エージェント向けのライブウェブ検索と Markdown 形式のウェブページ

PacketStream は、AI エージェントや LLM アプリに 2 つのウェブツールを提供する、ホスト型の Model Context Protocol（MCP）サーバーを運用しています。packetstream_search は、世界で最も利用されている検索エンジンでライブ検索を実行し、結果を Markdown と JSON で返します。packetstream_fetch は、PacketStream の住宅用ネットワークを経由してウェブページを取得し、要約ではなくページ自体を Markdown で返します。リモートサーバーに対応する MCP クライアントであれば、Claude Code、Codex、Cursor、Gemini CLI、VS Code、Claude Desktop、Cline などに接続できます。成功した呼び出し 1 回につきプリペイド残高から $0.0025（1,000 回あたり $2.50）が差し引かれ、サブスクリプションはありません。詳しくは料金をご覧ください。

このリポジトリには、Claude Code、Codex、Cursor、Gemini CLI 用のプラグインと拡張機能のファイルが含まれています。サーバーは PacketStream で稼働するため、ホストするものはありません。クライアント用のプラグインをインストールするか、任意の MCP クライアントからサーバー URL に接続してください。

ドキュメント全文：https://packetstream.io/docs/mcp/

ツール：ウェブ検索とページ取得

ツール	機能
packetstream_search	ライブウェブ検索を実行し、結果を Markdown で返します。JSON レスポンスは構造化コンテンツとして返されます。国、言語、場所、デバイス、ページ、期間を設定できます。結果の種類：search、news、shopping、places、autocomplete、scholar、ai_mode。
packetstream_fetch	公開されている http または https のページを 1 つ読み込み、要約ではなく Markdown で返します。最終 URL、HTTP ステータス、タイトルも含まれます。リクエストは PacketStream の住宅用ネットワークを経由します。

どちらのツールも読み取り専用です。成功した呼び出しごとの料金を除き、お使いのコンピューターや PacketStream アカウントに変更を加えることはありません。

packetstream_fetch について知っておくとよいこと：

• 静的な HTML のみを読み込みます。JavaScript が必要なページではエラーが返されます。
• デフォルトでは最大 40,000 文字を返します。ページがそれより長い場合、エージェントは次の文字位置から再度呼び出します。
• robots.txt は読み込みません。エージェントに読み込ませるサイトはご自身で選択してください。また、法律、契約、サイト運営者が求める許可がある場合は、それを取得する必要があります。利用規約のセクション 7をご覧ください。
• ページのテキストを信頼できないものとしてマークするため、エージェントはそれを指示ではなくデータとして扱います。

MCP リファレンスには、すべての引数と結果の形式が記載されています。同じ API キーは REST の Search API および Fetch APIでも使えるため、ご自身のコードから呼び出すこともできます。

サーバー URL

URL は 2 つあります。どちらも同じツールを同じ料金で提供します。クライアントの Streamable HTTP トランスポートを使用してください。

URL	接続方法
https://api.packetstream.io/v1/mcp/oauth	PacketStream アカウントでサインインします。クライアントがブラウザーで PacketStream のページを開くので、Allowを選択します。設定ファイルにキーを記載する必要はありません。
https://api.packetstream.io/v1/mcp	Authorization: Bearer YOUR_API_KEYとして送信するAPI キーを使用します。ヘッダーを設定できるクライアント向けです。

このリポジトリのプラグインではサインイン URL を使用します。

始める前に

1. サインアップし、残高に資金を追加します。
2. クライアントで API キーを使う場合は、ダッシュボードの MCP ページでキーを作成します。キーが表示されるのは 1 回だけなので、表示されたらコピーしてください。

プラグインをインストールするか、クライアントを接続する

Claude Code

claude plugin marketplace add packetstream/packetstream-mcp
claude plugin install packetstream@packetstream

Claude Code 2.1.275 以降では、Claude Code 内で次の手順を実行すると、両方を一度に行えます。

/plugin install packetstream --marketplace packetstream/packetstream-mcp

次に /mcp を実行し、packetstream を選択してサインインします。

Codex

codex plugin marketplace add packetstream/packetstream-mcp
codex plugin add packetstream@packetstream
codex mcp login packetstream

最後のコマンドを実行すると、ブラウザーでサインインページが開きます。

Cursor

PacketStream が Cursor Marketplace に掲載されている場合は、そこでインストールし、Cursor の指示に従ってサインインしてください。手動で設定するには、次の内容を ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "packetstream": {
      "url": "https://api.packetstream.io/v1/mcp/oauth"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/packetstream/packetstream-mcp

次に Gemini CLI を起動し、/mcp auth packetstream を実行してサインインします。

VS Code

ワークスペースの .vscode/mcp.json に追加するか、MCP: Open User Configuration を実行してすべてのワークスペースに適用します。VS Code は API キーを一度だけ尋ね、安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "packetstream-api-key",
      "description": "PacketStream API key",
      "password": true
    }
  ],
  "servers": {
    "packetstream": {
      "type": "http",
      "url": "https://api.packetstream.io/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:packetstream-api-key}" }
    }
  }
}

Claude と Claude Desktop

PacketStream をカスタムコネクターとして追加します。PacketStream アカウントでサインインするため、キーは不要です。

1. Claude で Customize > Connectors を開き、+ Add を選択してから、Add custom connector を選択します。
2. 名前を PacketStream にし、サーバー URL に https://api.packetstream.io/v1/mcp/oauth を入力します。
3. Claude がブラウザーで PacketStream を開きます。ログインして Allow を選択します。
4. チャットで + ボタンを押し、Connectors の下にある PacketStream をオンにします。

Team プランと Enterprise プランでは、最初にオーナーがコネクターを追加する必要があります。Claude のカスタムコネクターを参照してください。コネクターは Claude アカウントに紐付けられているため、Claude Desktop でも使用できます。Claude Desktop で代わりに API キーを使用する場合は、Claude Desktop のセットアップに従ってください。

Cline

Cline はトランスポートを設定しない場合、SSE を使用します。そのため、MCP 設定のサーバーに "type": "streamableHttp" を追加してください。

{
  "mcpServers": {
    "packetstream": {
      "type": "streamableHttp",
      "url": "https://api.packetstream.io/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

その他の MCP クライアント

リモートの Streamable HTTP サーバーに対応しているクライアントであれば、どれでも接続できます。API キーを Authorization ヘッダーに含めて https://api.packetstream.io/v1/mcp に送信するか、ChatGPT のように MCP サインイン（OAuth）に対応したクライアントでは https://api.packetstream.io/v1/mcp/oauth を使用してください。ChatGPT ではテストしていません。クライアントがローカル（stdio）サーバーのみに対応している場合は、mcp-remote ブリッジを使用してください。クライアントのセットアップには、各クライアントの設定とトラブルシューティングガイドが記載されています。

テスト済みの内容

Claude のカスタムコネクターを使って、サインインを最初から最後までテストしました。API キーを使ったセットアップは、Claude Code、Codex CLI、mcp-remote ブリッジでテストしました。Claude Code、Codex、Cursor、Gemini CLI でのサインイン、および VS Code と Cline のセットアップはテストしていません。これらの手順は各クライアントのドキュメントに従っています。クライアントでサインインに失敗する場合は、API キーを使ったセットアップを使用してください。

料金

• 検索とフェッチのいずれも、成功した呼び出し 1 回につき $0.0025（1,000 回あたり $2.50）がかかります。料金は PacketStream のプリペイド残高から差し引かれます。
• 課金で説明するまれなケースを除き、失敗した呼び出しは無料です。有効なキーまたはサインインなしで行われた呼び出しに料金が請求されることはありません。
• 接続とツールの一覧表示は無料です。
• 無料プランやサブスクリプションはありません。まず残高を追加する必要があり、最低購入額は $50 です。購入した残高に有効期限はありません。
• エージェントは、1 つのタスク内でこれらのツールを何度も呼び出すことがあります。支出を管理するには、クライアントのツール承認設定を確認してください。

制限：1 つのキーによるすべての呼び出しには、毎秒 20 回（バースト時は 200 回）の制限が適用されます。サインイン済みの各アプリには、同じ規模の独自の制限が適用されます。

プライバシー

• PacketStream は、検索クエリ、検索結果、取得した URL、ページのコンテンツを保存しません。各呼び出しについて、リクエスト ID と時刻、キーまたは接続済みアプリ、リクエストの種類、結果、処理したプロバイダー、試行回数、所要時間、料金を記録します。ダッシュボードでは、最近のリクエストと日ごとの使用状況を確認できます。
• 検索に回答するため、PacketStream 自身のアカウントを通じて、クエリとそのオプションをサードパーティの検索データプロバイダーに送信します。アカウントの識別情報、API キー、IP アドレスは送信しません。
• フェッチは PacketStream の住宅用ネットワークを経由します。そのネットワーク上のデバイスがページのコンテンツを読み取れるのは、そのページで暗号化されていない http が使われている場合に限られます。
• サインインするアプリが、パスワード、API キー、支払い情報、プロキシトラフィックを確認することはありません。利用できるのは MCP ツールのみです。アプリの接続を解除するには、ダッシュボードの MCP ページを使用してください。アプリ内で接続を解除すると、アプリに保存されたサインイン情報が削除されます。トークンの失効に対応しているアプリでは、PacketStream 側でも接続が終了します。それ以外の場合、30 日間使用されない状態が続くか、ダッシュボードで接続を解除するまで有効です。

プライバシーポリシーと利用規約の全文をお読みください。

サポート

• メール：[email protected]
• お問い合わせフォーム：https://packetstream.io/contact-us/
• トラブルシューティング：https://packetstream.io/docs/mcp/clients/#troubleshooting

ライセンス

このリポジトリ内のファイルは、Apache License 2.0に基づいてライセンスされています。「PacketStream」と PacketStream のロゴは PacketStream Inc. の商標であり、このライセンスはそれらの使用を許可するものではありません。NOTICEをご覧ください。