OpenWeather MCP Server

OpenWeather MCP Server

English | 中文版

世界各地の天気予報と現在の天気を提供する、シンプルな天気予報用 MCP（Model Control Protocol）サーバーです。

MCP Weather Service を使用する Claude Desktop のスクリーンショット

機能

• 個別の設定ファイルは不要です。API キーは環境変数またはパラメーターで直接渡せます。
• 世界中のあらゆる場所の天気を照会できます。
• 現在の天気と今後の予報を提供します。
• 気温、湿度、風速など、詳細な天気情報を提供します。
• 異なるタイムゾーンに対応しています。

インストール要件

pip install mcp-server requests pydantic

使用方法

1. OpenWeatherMap API キーを取得する

OpenWeatherMap にアクセスしてアカウントを登録し、API キーを取得します。

2. サーバーを実行する

API キーを指定する方法は 2 つあります。

方法 1：環境変数を使用する

# Set environment variables
export OPENWEATHER_API_KEY="your_api_key"  # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key  # Windows

# Run the server
python weather_mcp_server.py

方法 2：ツールの呼び出し時に指定する

環境変数を設定せずに直接実行します。

python weather_mcp_server.py

ツールを呼び出す際に、api_key パラメーターを指定する必要があります。

3. MCP クライアントの設定で使用する

以下の設定を MCP 対応クライアントに追加します。

{
  "weather_forecast": {
    "command": "python",
    "args": [
      "/full_path/weather_mcp_server.py"
    ],
    "env": {
      "OPENWEATHER_API_KEY": "your_openweathermap_key_here"
    },
    "disabled": false,
    "autoApprove": ["get_weather", "get_current_weather"]
  }
}

4. 使用可能なツール

get_weather

指定した場所の現在の天気と天気予報を取得します。

パラメーター：

• location：場所の名前。例：「Beijing」、「New York」、「Tokyo」
• api_key：OpenWeatherMap API キー（任意。指定しない場合は環境変数から読み取ります）
• timezone_offset：タイムゾーンのオフセット（時間単位）。例：北京は 8、ニューヨークは -4。デフォルトは 0（UTC 時刻）です。

get_current_weather

指定した場所の現在の天気を取得します。

パラメーター：

• location：場所の名前。例：「Beijing」、「New York」、「Tokyo」
• api_key：OpenWeatherMap API キー（任意。指定しない場合は環境変数から読み取ります）
• timezone_offset：タイムゾーンのオフセット（時間単位）。例：北京は 8、ニューヨークは -4。デフォルトは 0（UTC 時刻）です。

使用例

AI アシスタントの呼び出し例：

User: What's the weather like in New York right now?

AI: Let me check the current weather in New York for you.
[Calling get_current_weather("New York", timezone_offset=-4)]

Current weather in New York: 18°C, partly cloudy, humidity 65%, wind speed 3.5m/s.

トラブルシューティング

「No API key provided」エラーが発生した場合は、次の点を確認してください。

1. 環境変数に OPENWEATHER_API_KEY を設定していること。
2. または、ツールの呼び出し時に api_key パラメーターを指定していること。

場所の名前が正しくない場合、「Location not found」エラーが発生することがあります。より正確な都市名を使用するか、国コードを追加してください。例：「Beijing,CN」または「Paris,FR」。