Tester Client for Model Context Protocol (MCP)

Model Context Protocol（MCP）向けテスタークライアント

HTTP ストリーミング可能（推奨）トランスポートを使用して MCP サーバーに接続し、チャット形式の UI に会話を表示する Model Context Protocol（MCP）クライアントの実装です。 HTTP ストリーミング可能方式で MCP サーバーをテストするために設計された、スタンドアロンの Actor サーバーです。 従量課金の料金モデルを採用しています。

詳しくは、Model Context Protocol のウェブサイト、またはブログ記事 MCP とは何か、なぜ重要なのか？をご覧ください。

Actor を実行したら、出力またはログで、MCP サーバーとやり取りするためのチャット UI へのリンクを確認してください。 URL は次のような形式で、実行ごとに変わります。

Navigate to https://...apify.net to interact with chat-ui interface.

🚀 主な機能

• 🔌 HTTP ストリーミング可能を使用して MCP サーバーに接続
• 💬 ツールの呼び出しと結果を表示するチャット形式の UI を提供
• 🇦 Apify MCP Server に接続し、1 つ以上の Apify Actor とやり取り
• 💥（サーバーが対応している場合）コンテキストとユーザーのクエリに基づいてツールを動的に使用
• 🔓 安全な接続のために Authorization ヘッダーと API キーを使用
• 🪟 オープンソースなので、レビューや改善の提案、変更が可能

🎯 Tester MCP Client でできること

Apify MCP Server に接続すると、Tester MCP Client は次のような質問ができる対話型チャットインターフェースを提供します。

• 「ソーシャルメディアのスクレイピングで最も人気のある Actor はどれですか？」
• 「Instagram Scraper の最適な使い方を教えてください」
• 「LinkedIn からデータを抽出するには、どの Actor を使えばよいですか？」
• 「Google の検索結果をスクレイピングする方法を教えてもらえますか？」

📖 仕組み

Apify MCP クライアントは、実行中の MCP サーバーにHTTP ストリーミング可能方式で接続し、次の処理を行います。

• MCP サーバーへのストリーミング可能な HTTP 接続を開始します。
• ユーザーのクエリを MCP サーバーに送信します。
• LLM の出力やツールの使用ブロックを含む、リアルタイムのストリーミング応答を受信します。
• LLM の応答に基づいてツール呼び出しを調整し、会話を表示します。
• 会話を表示します。

⚙️ 使用方法

• 任意のリモート MCP サーバーをテストします
• Apify MCP Server と、数千のツールから動的に選択する機能をテストします

Apify MCP Server チュートリアル：5,000 以上の Apify Actor とエージェントを Claude に統合する動画で、主な機能と性能について学べます。

Apify MCP Server チュートリアル：5,000 以上の Apify Actor とエージェントを Claude に統合する

通常モード（Apify 上）

Apify 上で Tester MCP Client を実行し、HTTP ストリーミング可能方式に対応した任意の MCP サーバーに接続できます。 Apify UI または API で、MCP サーバーの URL、システムプロンプト、API キーなどのパラメーターを指定して設定できます。

Actor を実行したら、ログで Tester MCP Client UI へのリンクを確認してください。そこから MCP サーバーとやり取りできます。 URL は次のような形式で、実行のたびに異なります。

INFO  Navigate to https://......runs.apify.net in your browser to interact with an MCP server.

💰 料金

Apify MCP クライアントでは、AI エージェントの収益化と料金設定に、従量課金と呼ばれる、最新で柔軟な方式を採用しています。 Apify アカウントがあれば利用できます。LLM プロバイダーの API キーは必須ではありませんが、独自の LLM プロバイダーを使用する場合は指定できます。

サポート対象のモデル

現在のモデル：

• Claude Sonnet 4.5 (claude-sonnet-4-5-20250929) - Sonnet のデフォルト
• Claude Haiku 4.5 (claude-haiku-4-5-20251001) - デフォルトモデル。より高速で費用対効果に優れています

非推奨モデル（自動移行により引き続きサポート）：

• Claude Sonnet 4.0 (claude-sonnet-4-0) → Sonnet 4.5 に移行します
• Claude Sonnet 3.7 (claude-3-7-sonnet-latest) → Sonnet 4.5 に移行します
• Claude Haiku 3.5 (claude-3-5-haiku-latest) → Haiku 4.5 に移行します

課金対象のイベント

• Actor の起動（使用メモリ量に基づき、128 MB 単位で課金）
• 実行時間（5 分ごとに、128 MB 単位で課金）
• クエリへの回答（使用モデルによって異なります。LLM プロバイダーの API キーを独自に指定した場合は課金されません）

トークン料金

• Claude Sonnet：入力トークン 100 万件あたり $3、出力トークン 100 万件あたり $15
• Claude Haiku：入力トークン 100 万件あたり $1、出力トークン 100 万件あたり $5（デフォルトモデル）

独自の LLM プロバイダーの API キーを使用する場合、128 MB のメモリで MCP Client を 1 時間実行すると、費用は約 $0.06 です。 クレジットカード不要の Apify Free プランでは、MCP Client を月 80 時間実行できます。 MCP サーバーのテストには十分です！

📖 仕組み

Browser ← (SSE) → Tester MCP Client  ← (HTTP streamable) → MCP Server

このチェーンを作成することで、カスタムのブリッジ処理をすべて Tester MCP Client 内に収め、メインの MCP Server は変更せずに済みます。 ブラウザーは SSE を使って Tester MCP Client と通信し、Tester MCP Client は HTTP streamable を使って MCP Server と通信します。 この仕組みにより、クライアント側の追加ロジックをコアサーバーから分離できるため、保守やデバッグが容易になります。

1. https://tester-mcp-client.apify.actor?token=YOUR-API-TOKEN にアクセスします（ローカルで実行している場合は http://localhost:3000 にアクセスします）。
2. ファイル index.html と client.js は public/ ディレクトリから提供されます。
3. ブラウザーは GET /sse を介して SSE ストリームを開きます。
4. ユーザーのクエリは POST /message で送信されます。
5. クエリの処理：
   • 大規模言語モデルを呼び出します。
   • 必要に応じて、以下を使用してツールを呼び出します
6. 結果の各チャンクについて、sseEmit(role, content)

ローカル開発

Tester MCP Client Actor はオープンソースで、GitHub で公開されています。必要に応じて変更、開発できます。

ソースコードをダウンロードします：

git clone https://github.com/apify/tester-mcp-client.git
cd tester-mcp-client

依存関係をインストールします：

npm install

.env ファイルを作成し、以下の内容を記述します（.env.example ファイルを参考にしてください）：

APIFY_TOKEN=YOUR_APIFY_TOKEN
LLM_PROVIDER_API_KEY=YOUR_API_KEY

mcpUrl、systemPrompt などの設定のデフォルト値は、const.ts ファイルで定義されています。開発に合わせて調整できます。

クライアントをローカルで実行します

npm start

ブラウザーで http://localhost:3000 にアクセスして、MCP サーバーを操作します。

Apify Actors とのチャットをお楽しみください！

ⓘ 制限事項とフィードバック

このクライアントは、Prompts や Resource など、すべての MCP 機能をサポートしているわけではありません。

参考資料

• Model Context Protocol
• Apify MCP Server
• Apify MCP Server
• イベントごとの従量課金モデル
• AI エージェントとは？
• MCP とは何か、なぜ重要なのか？
• Apify Actors で MCP を使用する方法
• Apify MCP Server チュートリアル：5,000 以上の Apify Actors とエージェントを Claude に統合する