MCP Weather Application (Client-Server)

MCP Weather Application（クライアント・サーバー）

このプロジェクトでは、MCP（Model Context Protocol）フレームワークを使用して天気情報を取得するクライアント・サーバーアプリケーションを紹介します。

• weather/：National Weather Service（NWS）APIからデータを取得するMCPサーバーのコードが含まれています。
• mcp-client/：サーバーと連携し、GroqとともにLangChainを使用して自然言語のクエリを処理するMCPクライアントのコードが含まれています。

説明

MCP サーバー（weather/）は、MCP経由で利用できる特定のツール（get_alerts、get_forecast）を提供します。これらのツールを通じて行われたリクエストに対応するため、NWS APIに接続します。

MCP クライアント（mcp-client/）はMCPサーバーに接続してツールを検出し、チャットインターフェースを通じてユーザーが操作できるようにします。LangChainとGroq API（Llama 3モデル）を使用して自然言語のクエリを処理し、サーバーのツールが必要かどうかを判断し、必要に応じてMCP経由でツールを呼び出し、最終的な回答を作成します。

アーキテクチャ

1. クライアントが起動し、サーバースクリプトへのMCP接続（stdio経由）を開始します。
2. クライアントがサーバーで利用可能なツールを検出します。
3. ユーザーがクライアントに自然言語のクエリを入力します。
4. クライアントがGroq LLM（LangChain経由）を使用してクエリを解釈し、サーバーのツールを使用する必要があるかどうかを判断します。
5. ツールが必要な場合、クライアントは必要な引数を指定したMCPリクエストをサーバーに送信し、特定のツール（例：get_forecast）を実行します。
6. サーバーがツールのロジックを実行し、NWS APIからデータを取得します。
7. サーバーがMCP経由で結果をクライアントに返します。
8. クライアントがツールの結果をLLMとの会話に取り込みます。
9. クライアントがLLMによって生成された最終回答をユーザーに提示します。

セットアップ

依存関係のインストールやAPIキーなどの環境設定を含む詳しいセットアップ手順については、各コンポーネントのディレクトリにあるREADMEファイルを参照してください。

• サーバーのセットアップ： weather/README.mdを参照してください
• クライアントのセットアップ： mcp-client/README.mdを参照してください

アプリケーションの実行

クライアントを実行してサーバーを自動的に起動・接続するには、mcp-client/（client.pyがあるディレクトリ）から次のコマンドを実行してください。

uv run client.py ../weather/weather.py