Openweather MCP Server

🚀 OpenWeather MCP サーバー

このサーバーは、シンプルな天気予報 MCP（モデル制御プロトコル）サーバーで、世界中の天気予報と現在の天気状況を提供します。

Claude Desktop で MCP 天気サービスを使用したスクリーンショット

✨ 主な機能

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

📦 インストール

pip install mcp-server requests pydantic

💻 使用例

1. OpenWeatherMap API キーの取得

OpenWeatherMap にアクセスし、アカウントを登録して API キーを取得してください。

2. サーバーの起動

API キーを提供する方法は以下の 2 通りがあります。

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

# 環境変数の設定
export OPENWEATHER_API_KEY="your_api_key"  # Linux/Mac
set OPENWEATHER_API_KEY=your_api_key  # Windows

# サーバーの起動
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：場所の名前（例：「北京」、「ニューヨーク」、「東京」）
• api_key：OpenWeatherMap API キー（オプション、デフォルトでは環境変数から読み取ります）
• timezone_offset：タイムゾーンのオフセット（時間）。例えば、8 は北京、-4 はニューヨークを表します。デフォルトは 0（UTC 時間）です。

get_current_weather

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

パラメーター：

• location：場所の名前（例：「北京」、「ニューヨーク」、「東京」）
• api_key：OpenWeatherMap API キー（オプション、デフォルトでは環境変数から読み取ります）
• timezone_offset：タイムゾーンのオフセット（時間）。例えば、8 は北京、-4 はニューヨークを表します。デフォルトは 0（UTC 時間）です。

基本的な使用法

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

ユーザー：ニューヨークの現在の天気はどうですか？

AI：ニューヨークの現在の天気を調べます。
[get_current_weather("New York", timezone_offset=-4) を呼び出す]

ニューヨークの現在の天気：18°C、曇り、湿度 65%、風速 3.5m/s。

📚 ドキュメント

トラブルシューティング

「API キーが提供されていません」というエラーが発生した場合は、以下を確認してください。

1. 環境変数に OPENWEATHER_API_KEY が設定されていること、または
2. ツールを呼び出す際に api_key パラメーターが提供されていること

場所の名前が正しくない場合、「場所が見つかりません」というエラーが表示されることがあります。より正確な都市名を使用するか、国コードを追加してみてください。例えば、「Beijing,CN」や「Paris,FR」などです。