MCP Weather SSE Server

MCP Weather SSE Server

Server-Sent Events（SSE）を介して OpenWeatherMap API に接続する Model Context Protocol（MCP）サーバーです。このサーバーは、Claude、CursorAI、MCP-Inspector などの AI クライアントにリアルタイムの天気データを提供します。

機能

• AI ツールとシームレスに統合するための Model Context Protocol を実装
• リアルタイム通信に 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  # On Windows: venv\Scripts\activate
   pip install mcp requests
   

使用方法

サーバーの起動

OpenWeatherMap API キーを使ってサーバーを起動できます：

# Using command line argument
python mcp_weather_sse.py --api-key YOUR_API_KEY

# Using environment variable
export OPENWEATHER_API_KEY=YOUR_API_KEY
python mcp_weather_sse.py

# Customize host and port (default: 127.0.0.1:3001)
python mcp_weather_sse.py --host 0.0.0.0 --port 8080

MCP クライアントとの接続

Cursor AI

1. Cursor AI を開きます
2. File → Preferences → Cursor Settings → MCP → Add New Server に移動します
3. 以下の詳細を入力します：
   • 名前：Weather SSE
   • 種類：sse
   • URL：http://127.0.0.1:3001/sse

Claude Desktop

1. Claude Desktop を開きます
2. Settings → MCP Servers に移動します
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

クエリの例

接続したら、以下のクエリを使ってサーバーとやり取りできます：

1. 「ニューヨークの現在の天気は？」
2. 「東京の3日間の天気予報を教えてもらえますか？」
3. 「座標 40.7128, -74.0060 の天気は？」

API リファレンス

get_current_weather

都市の現在の天気を取得します。

パラメーター：

• city（文字列）：都市名（例：'London'、'New York'）
• units（文字列、任意）：測定単位（'metric' または 'imperial'、デフォルト：'metric'）

get_weather_forecast

都市の数日間の天気予報を取得します。

パラメーター：

• city（文字列）：都市名（例：'London'、'New York'）
• days（整数、任意）：予報の日数（1～5、デフォルト：3）
• units（文字列、任意）：測定単位（'metric' または 'imperial'、デフォルト：'metric'）

get_weather_by_coordinates

指定した地理座標の天気を取得します。

パラメーター：

• latitude（数値）：緯度座標
• longitude（数値）：経度座標
• units（文字列、任意）：測定単位（'metric' または 'imperial'、デフォルト：'metric'）

セキュリティに関する考慮事項

• サーバーはデフォルトで 127.0.0.1 にバインドされるため、ローカルマシンからのみアクセスできます
• 本番環境で使用する場合は、適切な認証と HTTPS を実装してください
• OpenWeatherMap API の利用枠を超えないよう、レート制限を検討してください

ライセンス

MIT

謝辞

• Model Context Protocol を使用して構築
• OpenWeatherMap API のデータを使用