🏓 MCP Ping-Pong Server with FastAPI

🏓 Remote Call による MCP Ping-Pong サーバー

FastAPI を介した MCP（Model Context Protocol）呼び出しを実演する、実験的かつ教育目的の Ping-Pong サーバーです。

機能

• ✅ API エンドポイントまたは SSE を介したリモート MCP 呼び出しに対応する FastAPI/FastMCP バックエンド
• 🔄 コマンド処理のための MCP 統合
• 🔐 スレッドセーフなセッション管理

クイックスタート

インストール

依存関係をインストールするには、次を実行します。

poetry install

1. API 経由で MCP ツールを呼び出す

サーバーを起動する

次のコマンドで FastAPI サーバーを起動します。

python mcp-api-server.py

サーバーは http://localhost:8080 で起動します。

UI

ブラウザーで mcp-api-client.html を開くと、UI を操作できます。

API エンドポイント

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

2. SSE トランスポート経由で MCP ツールを呼び出す

次の例では、MCP サーバーとの通信に Server-Sent Events（SSE）を使用します。

SSE サーバーを起動する

python mcp-sse-server.py

SSE クライアントを起動する

python mcp-sse-client.py

出力例

Type a command (e.g., 'ping', 'pong', 'count') or 'exit' to quit:
>>> ping
Sending command: ping
Result: pong
>>> pong
Sending command: pong
Result: ping
>>> count
Sending command: count
Result: 2

参考資料

• FastAPI SSE MCP
• MCP Weather SSE
• MCP Chinese Getting Started Guide

📄 ライセンス

MIT