Github Q2w

🚀 SSE ベースの MCP サーバーとクライアントのサンプル MCP

このプロジェクトは、SSE（Server-Sent Events）をベースとした MCP（Model Context Protocol）サーバーと、独立した MCP クライアントツールの動作モードを示しています。このアイデアは、ここ で行われた元の議論に着想を得ています。

🚀 クイックスタート

💡 重要な注意事項

⚠️ 重要提示

.env ファイルまたは環境変数に ANTHROPIC_API_KEY を設定してください。

実行コマンド

サーバーを起動するには以下のコマンドを実行します。

uv run weather.py

クライアントを起動し、サーバーに接続するには以下のコマンドを実行します。

uv run client.py http://0.0.0.0:8080/sse

実行結果の例

Initialized SSE client...
Listing tools...

Connected to server with tools: ['get_alerts', 'get_forecast']

MCP Client Started!
Type your queries or 'quit' to exit.

Query: whats the weather like in Spokane?

I can help you check the weather forecast for Spokane, Washington. I'll use the get_forecast function, but I'll need to use Spokane's latitude and longitude coordinates.

Spokane, WA is located at approximately 47.6587° N, 117.4260° W.
[Calling tool get_forecast with args {'latitude': 47.6587, 'longitude': -117.426}]
Based on the current forecast for Spokane:

Right now it's sunny and cold with a temperature of 37°F and ...

✨ 主な機能

このアプローチの利点は、MCP サーバーが常に実行されているプロセスとして存在でき、代理（クライアント）がいつでも接続、使用、切断できることです。つまり、SSE ベースのサーバーとクライアントは、分離されたプロセス（場合によっては分離されたノード）で動作できます。これは、クライアント自身が子プロセスとしてサーバーを起動する必要がある STDIO ベースのモデルとは異なります。

📦 インストール

Smithery を通じたインストール

Smithe ry を使用して、SSE ベースの MCP サーバーとクライアントを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @sidharthrajaram/mcp-sse --client claude

サーバー

weather.py は SSE ベースの MCP サーバーで、国家気象局の API をベースとしたいくつかのツールを提供します。このコードは、MCP ドキュメントの サンプル STDIO サーバー実装 を改変したものです。

デフォルトでは、サーバーは 0.0.0.0:8080 で動作しますが、コマンドライン引数で設定を変更できます。

uv run weather.py --host <your host> --port <your port>

クライアント

client.py は MCP クライアントで、SSE ベースの MCP サーバーに接続してツールを使用します。このコードは、MCP ドキュメントの サンプル STDIO クライアント実装 を改変したものです。

デフォルトでは、クライアントはコマンドライン引数で SSE エンドポイントに接続します。

uv run client.py http://0.0.0.0:8080/sse