MCP Weather Sse

🚀 MCP 天気 SSE サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を実装し、Server-Sent Events (SSE) を介して OpenWeatherMap API に接続します。Claude、CursorAI、または MCP-Inspector などの AI ツールにリアルタイムの天気データを提供します。

✨ 主な機能

• AI ツールとのシームレスな統合を実現するために、モデルコンテキストプロトコルを実装します。
• リアルタイム通信のために、Server-Sent Events (SSE) 伝送プロトコルを使用します。
• リアルタイムの天気データを取得するために、OpenWeatherMap API に接続します。
• 以下の3つのツールを提供します：
  • get_current_weather：特定の都市の現在の天気状況を取得します。
  • get_weather_forecast：特定の都市の複数日の天気予報を取得します。
  • get_weather_by_coordinates：地理座標に基づいて天気情報を取得します。

📦 インストール

前提条件

• Python 3.8+
• OpenWeatherMap API キー（openweathermap.org で登録して取得）

インストール手順

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

   git clone https://github.com/yourusername/mcp-weather-sse.git
   cd mcp-weather-sse
   

2. 仮想環境を作成し、依存関係をインストールします：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合：venv\Scripts\activate
   pip install mcp requests
   

💻 使用例

サーバーの起動

以下の方法でサーバーを起動できます：

# コマンドライン引数を使用する
python mcp_weather_sse.py --api-key YOUR_API_KEY

# 環境変数を使用する
export OPENWEATHER_API_KEY=YOUR_API_KEY
python mcp_weather_sse.py

# ホストとポートをカスタマイズする（デフォルト：127.0.0.1:3001）
python mcp_weather_sse.py --host 0.0.0.0 --port 8080

MCP クライアントとの接続

Cursor AI

1. Cursor AI を開きます。
2. 「ファイル」→「設定」→「Cursor 設定」→「MCP」→「新しいサーバーを追加」に移動します。
3. 以下の情報を入力します：
   • 名前：天気 SSE
   • タイプ：sse
   • URL：http://127.0.0.1:3001/sse

Claude Desktop

1. Claude Desktop を開きます。
2. 「設定」→「MCP サーバー」に移動します。
3. 新しいサーバーを追加し、以下のように設定します：

   {
     "mcpServers": {
       "weather": {
         "type": "sse",
         "url": "http://127.0.0.1:3001/sse"
       }
     }
   }
   

MCP-Inspector

MCP-Inspector ツールを使用してサーバーをテストできます：

npm install -g @anthropic-ai/mcp-inspector
mcp-inspector http://127.0.0.1:3001/sse

📚 ドキュメント

API リファレンス

get_current_weather

指定した都市の現在の天気情報を取得します。

リクエスト

GET /weather/current?city={city}

レスポンス

{
  "temperature": {number},
  "condition": {string},
  "humidity": {number},
  "windSpeed": {number}
}

get_weather_forecast

指定した都市の複数日の天気予報を取得します。

リクエスト

GET /weather/forecast?city={city}&days={days}

レスポンス

[
  {
    "date": "{date}",
    "temperature": {number},
    "condition": {string},
    "humidity": {number},
    "windSpeed": {number}
  },
  ...
]

get_weather_by_coordinates

緯度と経度に基づいて天気情報を取得します。

リクエスト

GET /weather/coordinates?lat={latitude}&lon={longitude}

🔧 セキュリティに関する注意事項

• OpenWeatherMap API キーの安全性を確保し、コード内に平文で保存しないようにしてください。
• 本番環境では HTTPS を使用してデータを送信し、安全性を確保してください。