Weather MCP Server Ujh

🚀 天気 MCP プロジェクト

このプロジェクトは、Model Context Protocol (MCP) をベースにした天気関連のサービスを実現しています。このサービスは、天気警報の取得や天気予報の提供機能を備えており、シェルコマンドの実行やシステムリソースの確認ができるシステムツールも含まれています。

✨ 主な機能

• 天気警報：州コード（例："CA", "NY", "FL"）を入力することで、指定地域の天気警報情報を取得できます。
• 天気予報：緯度と経度の座標を提供することで、その位置の天気予報データを取得できます。
• システムツール：任意のシェルコマンドを実行し、結果を確認できます。
• リソース閲覧：利用可能なシステムリソースとその現在の状態を確認できます。

🚀 クイックスタート

📦 インストール

必要な依存ライブラリを pip を使ってインストールします。

pip install "mcp[server]" requests

プロジェクトの初期化

新しい MCP サーバーインスタンスを作成し、天気ツールとシステムリソースを登録します。

from mcp import Server
import subprocess
import requests

server = Server()

# 天気ツールの登録
@server.tool()
async def get_weather_alerts(state: str) -> dict:
    """
    指定された州の天気警報情報を取得します。
    
    Args:
        state: 州コード（例："CA", "NY", "FL"）
        
    Returns:
        天気警報の詳細情報
    """
    # 天気警報を取得する具体的なロジックを実装
    return {"state": state, "alerts": []}

@server.tool()
async def get_forecast(latitude: float, longitude: float) -> dict:
    """
    指定された緯度と経度の位置の天気予報を取得します。
    
    Args:
        latitude: 緯度座標
        longitude: 経度座標
        
    Returns:
        天気予報のデータ
    """
    # 天気予報を取得する具体的なロジックを実装
    return {"latitude": latitude, "longitude": longitude, "forecast": []}

# システムリソースの登録
@server.resource()
def top_processes() -> str:
    """
    システムのプロセス情報を取得します。
    
    Returns:
        プロセス情報の文字列形式
    """
    # プロセス情報を取得する具体的なロジックを実装
    return subprocess.run("ps aux", capture_output=True, text=True).stdout

# サーバーの起動
server.start()

サーバーの起動

MCP サーバーを起動します。

python your_server_script.py

💻 使用例

ツールのテスト

MCP CLI ツールを使用して、登録されたツールとリソースをテストします。

1. 利用可能なすべてのツールをリスト表示します。

mcp list-tools http://localhost:8000

2. 天気警報を取得するツールを呼び出します。

mcp call-tool http://localhost:8000 get_weather_alerts --args '{"state": "CA"}'

3. 天気予報を取得します。

mcp call-tool http://localhost:8000 get_forecast --args '{"latitude": 37.7749, "longitude": -122.4194}'

4. システムリソースを確認します。

mcp list-resources http://localhost:8000

5. プロセス情報を取得します。

mcp get-resource http://localhost:8000 top_processes

MCP Inspector を使用したデバッグ

MCP Inspector は、MCP サーバーの機能を探索およびテストするための Web インターフェースツールです。

1. MCP Inspector を起動します。

make dev-server

2. ブラウザを開き、http://localhost:5173 にアクセスします。
3. Inspector でツールの探索、ツールの呼び出し、リソースの閲覧、問題のデバッグを行います。

📚 ドキュメント

新しいツールの追加

新しいツールを追加するには、以下の手順に従ってください。

1. 該当するツールモジュールに関数を作成します。
2. @server.tool() デコレータを使用して、その関数を登録します。
3. tools/__init__.py のツール登録情報を更新します。

以下はサンプルコードです。

@server.tool()
async def my_new_tool(param1: str, param2: int) -> str:
    """
    ツールの説明。
    
    Args:
        param1: パラメータ 1 の説明
        param2: パラメータ 2 の説明
        
    Returns:
        戻り値の説明
    """
    # ツールの具体的なロジックを実装
    return 結果

新しいリソースの追加

新しいリソースを追加するには、以下の手順に従ってください。

1. 該当するリソースモジュールに関数を作成します。
2. @server.resource() デコレータを使用して、その関数を登録します。
3. resources/__init__.py のリソース登録情報を更新します。

🔧 技術詳細

プロジェクト構造

your_project/
├── server.py          # MCP サーバーの実装
├── tools/            # ツールモジュール
│   ├── weather.py    # 天気ツール
│   └── system.py     # システムツール
├── resources/        # リソースモジュール
│   ├── weather_data.py  # 天気データリソース
│   └── system_info.py   # システム情報リソース
└── requirements.txt  # 依存関係管理ファイル

依存関係管理

プロジェクトの依存関係は requirements.txt ファイルに含まれており、pip を使用してインストールできます。

pip install -r requirements.txt

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。

🔗 貢献ガイド

貢献を歓迎します！開発への参加方法の詳細ガイドは、CONTRIBUTING.md を参照してください。

このプロジェクトは、MCP プロトコルを利用して、天気サービスとシステムツールを統合した機能プラットフォームを迅速に構築する方法を示しています。ツールとリソースモジュールを拡張することで、その機能と適用シーンをさらに強化することができます。