MCP Hge

🚀 MCP 天気ツール

このツールは MCP プロトコルを用いたシンプルなコマンドラインツールで、クライアント - サーバーアーキテクチャを通じてアメリカの天気データにアクセスできます。また、Google の Gemini AI を利用した自然言語インターフェースも備えています。

🚀 クイックスタート

このプロジェクトは Python クライアントアプリケーションと天気データサーバーを接続し、ユーザーが自然言語で天気情報を問い合わせることを可能にします。サーバーはモデルコンテキストプロトコル（MCP）を通じて国家気象局 API と通信し、天気警報や予報を取得します。

✨ 主な機能

• 州コードを使用して、アメリカ各州の現在の天気警報を照会することができます。
• 緯度と経度を使用して、特定の場所の詳細な天気予報を取得することができます。
• Google の Gemini AI を利用した自然言語インターフェースを提供します。
• モデルコンテキストプロトコル（MCP）を通じたクライアント - サーバーアーキテクチャを実装しています。

📦 インストール

前提条件

• Python 3.8+
• Node.js（JavaScript サーバーを実行する場合）
• Google Gemini API キー

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/Abhinavexists/MCP_Server.git
   cd weather-tool
   

2. uv がない場合は、インストールします：

   pip install uv
   

3. 仮想環境を作成してアクティブ化します：

   • Windows の場合：.venv\Scripts\activate
   • macOS/Linux の場合：source .venv/bin/activate

4. uv を使用して依存関係をインストールします（このプロジェクトは uv.lock と pyproject.toml を使用しています）：

   uv pip sync
   

5. プロジェクトのルートディレクトリに .env ファイルを作成し、Gemini API キーを追加します：

   GEMINI_API_KEY=your_gemini_api_key_here
   

💻 使用例

基本的な使用法

1. クライアントを実行し、天気サーバーに接続します：

   python client.py server.py
   

2. 接続後、天気情報に関する質問をすることができます：

   • 問い合わせ例：「カリフォルニア州に現在どのような天気警報がありますか？」
   • 問い合わせ例：「緯度 37.7749、経度 -122.4194 の場所の天気予報はどうなっていますか？」

3. quit と入力すると、アプリケーションを終了します。

提供されるツール

サーバーは以下のツールを提供します：

• get_alerts：指定されたアメリカの州（2 文字の州コードを使用）の天気警報を取得します。
• get_forecast：緯度と経度に基づいて、特定の場所の天気予報を取得します。

📚 ドキュメント

プロジェクト構造

• client.py：MCP クライアントで、サーバーに接続し、Gemini AI を使用してユーザーの問い合わせを処理します。
• server.py：MCP サーバーで、天気データツールを実装し、国家気象局 API と通信します。

エラー処理

このアプリケーションには、以下のエラー処理機能が含まれています：

• 無効なサーバースクリプトパス
• NWS API との接続問題
• API 応答に欠落または無効なデータが含まれている場合

将来の改善方向

• 他の天気データエンドポイントを追加する予定です。
• 一般的なデータのキャッシュ機能を実装する予定です。
• 位置名による照会をサポートする予定です（緯度と経度の入力を要求しないように）。
• ウェブページインターフェースを作成する予定です。

📄 ライセンス

MIT License

リソース

モデルコンテキストプロトコル（MCP）に関する詳細情報は、公式の Claude MCP ドキュメントを参照してください：

• Claude MCP 公式ドキュメント