MCP Remote Call Ping Pong

🚀 🏓 ピンポン MCP リモート呼び出しサーバー

実験的かつ教育的なピンポンサーバーで、FastAPI を通じた MCP（モデルコンテキストプロトコル）のリモート呼び出しをデモンストレーションします。

✨ 主な機能

• ✅ FastAPI/FastMCP ベースのバックエンドで、API エンドポイントまたは SSE を通じたリモート MCP 呼び出しをサポート
• 🔄 MCP と統合されたコマンド処理機能
• 🔐 スレッドセーフなセッション管理

🚀 クイックスタート

📦 インストール

以下のコマンドを実行して、すべての依存関係をインストールします。

poetry install

1. API を通じた MCP ツールの呼び出し

サーバーの起動

以下のコマンドを使用して、FastAPI サーバーを起動します。

python mcp-api-server.py

サーバーは http://localhost:8080 で実行されます。

インターフェースのアクセス

ブラウザで mcp-api-client.html ファイルを開くと、インターフェースを通じてピンポンサーバーとやり取りできます。インターフェースの例は以下の通りです。

API エンドポイントの説明

• GET /ping-pong?prompt_name=<prompt_name>：指定されたプロンプト情報を取得します。
• POST /ping-pong：MCP ツールコマンド（ping, pong, count など）を呼び出します。

2. SSE を通じた MCP ツールの呼び出し

以下の例は、サーバー送信イベント（SSE）を使用して MCP サーバーと通信する方法を示しています。

SSE サーバーの起動

以下のコマンドを実行して、SSE サーバーを起動します。

python mcp-sse-server.py

SSE クライアントの起動

以下のコマンドを実行して、SSE クライアントを起動します。

python mcp-sse-client.py

出力例

コマンドを入力してください（例：ping, pong, count）または exit で終了します。
>>> ping
コマンドを送信：ping
結果：pong
>>> pong
コマンドを送信：pong
結果：ping
>>> count
コマンドを送信：count
結果：2

📚 参考資料

• FastAPI SSE MCP
• MCP 天気 SSE
• MCP 中国語入門ガイド

📄 ライセンス

MIT