Weather MCP Server by Meteosource

Meteosource の Weather MCP サーバー

AI エージェント向けの気象データです。Meteosource は次の場所でサーバーをホストしています。

https://mcp.meteosource.com/mcp

Streamable HTTP を介して Model Context Protocol を使用します。Claude Code、Claude Desktop、Codex、Antigravity、その他の MCP クライアントに接続し、ヘッダーに Meteosource API キーを送信すると、エージェントは予報、公式の気象警報、大気質、過去 20 年間の気象データ、太陽光発電システムや風力発電所の発電量を調べられます。

インストールもホスティングも不要です。サーバーは独自のキーを保持せず、すべてのリクエストはリクエストに含まれるキーを使い、そのキーが利用しているプランの範囲内で処理されます。

ツール

ツール	機能
search_places	地名、郵便番号、座標を、他のツールで使う place_id に変換します
get_forecast	最大 20 か所の現在の状況、1 時間ごと（最大 168 時間）および 1 日ごと（最大 30 日間）の予報、分単位の降水量、警報を 1 回の呼び出しで取得します。variables フィルターを使うと回答を簡潔にできます
get_alerts	最大 20 か所の公式の重大気象警報を取得します。警報がある場所のみを返します。対象地域は米国、EU、カナダです
get_weather_history	過去の気象データを取得します。1 時間ごとのデータは 1 回の呼び出しにつき最大 14 日間、1 日ごとまたは 1 か月ごとのデータは最大 366 日間で、サーバー上で集計されます。normals=true を指定すると長期平年値と記録が追加されます。wind_distribution は風力タービンの設置場所選定に役立つ、風速帯ごとの時間数を返します
get_air_quality	約 4 日先までの 1 時間ごとの大気質を取得します。指標、PM10、PM2.5、NO₂、SO₂、O₃ などが含まれます
get_solar_production	場所、モジュールとインバーターの出力、傾斜角、方位角を指定して、太陽光発電システムの発電量を取得します。1 時間ごとの出力、1 日ごとまたは 1 か月ごとの電力量を、過去 20 年前から 4 日先まで取得できます
get_wind_production	場所、タービンモデル、台数または容量、ハブ高さ、地形を指定して、風力発電所の発電量を取得します。1 時間ごとの出力、1 日ごとまたは 1 か月ごとの電力量を、過去 20 年前から 4 日先まで取得できます

サーバーはツールの連携方法をエージェントに伝えるため、「明日のブルノは雨ですか？」のような質問は、明示しなくても search_places の呼び出しに続いて get_forecast が実行されます。

接続する前に

Meteosource API キーが必要です。meteosource.com で登録し（予報ツールを試すだけなら無料プランで十分です）、アカウントからキーをコピーしてください。

キーはすべてのリクエストの Authorization ヘッダーに Bearer <key> として含まれます。以下の設定で必要なのは、上記の URL とこのヘッダーの 2 つだけです。

それ以外はサーバーが自動で処理します。Meteosource にキーのプランを問い合わせ、そのプランに含まれるツールを提供します。プラン対象外のツールを呼び出すと、その旨を説明する文が返されます。プランと制限を参照してください。

接続

Claude Code

コマンドを 1 つ実行します。

claude mcp add --transport http meteosource https://mcp.meteosource.com/mcp \
  --header "Authorization: Bearer YOUR_METEOSOURCE_API_KEY"

これにより、現在のプロジェクトにサーバーが登録されます。すべてのプロジェクトで使うには --scope user を追加してください。claude mcp list で接続状況を確認でき、セッション内で /mcp を実行するとツールの一覧が表示されます。

キーを共有せずにチームと設定を共有するには、プロジェクトのルートに .mcp.json をコミットし、各自が環境変数にキーを保持するようにします。

{
  "mcpServers": {
    "meteosource": {
      "type": "http",
      "url": "https://mcp.meteosource.com/mcp",
      "headers": {
        "Authorization": "Bearer ${METEOSOURCE_API_KEY}"
      }
    }
  }
}

Claude Desktop と claude.ai

コネクターはアカウントに紐づいているため、ウェブ上で追加したコネクターはデスクトップアプリにも表示され、その逆も同様です。

1. Customize > Connectors（デスクトップアプリでは Settings > Connectors）を開き、Add custom connectorをクリックします。
2. Meteosourceという名前を付けます。URLはhttps://mcp.meteosource.com/mcpです。
3. AuthenticationでNo sign-inを選択します。
4. Request headersで、Authorizationを追加し、値に Bearer YOUR_METEOSOURCE_API_KEYを指定します。Bearerという語とその後のスペースは自分で入力してください。Claudeは入力した値をそのまま送信します。
5. Addをクリックします。チャットで**+**メニューを開き、Connectorsを選択して、Meteosourceをオンにします。

TeamプランとEnterpriseプランでは、オーナーがOrganization settings > Connectorsでコネクターを追加し、メンバーはCustomize > Connectorsから接続します。無料プランでは、カスタムコネクターを1つ利用できます。

Codex

Codex CLI、Codexアプリ、IDE拡張機能は、いずれも同じファイル~/.codex/config.tomlを読み込むため、3つすべてでサーバーを一度だけ設定すれば済みます。ターミナルで次を実行します。

codex mcp add meteosource --url https://mcp.meteosource.com/mcp \
  --bearer-token-env-var METEOSOURCE_API_KEY

そして、シェルのプロファイルでMETEOSOURCE_API_KEYをエクスポートします。これによりファイルに書き込まれるセクションは次のとおりです。

[mcp_servers.meteosource]
url = "https://mcp.meteosource.com/mcp"
bearer_token_env_var = "METEOSOURCE_API_KEY"

Codexアプリには専用のダイアログ（Settings > MCP servers > Add serverで、Streamable HTTPを選択）がありますが、キーを入力する欄はありません。アプリでサーバーが失敗と表示される場合、環境変数が渡されていません。Dockやスタートメニューから起動したアプリには、ターミナルでエクスポートした内容は認識されません。代わりに、キーをファイルに記述してください。

[mcp_servers.meteosource]
url = "https://mcp.meteosource.com/mcp"
http_headers = { Authorization = "Bearer YOUR_METEOSOURCE_API_KEY" }

Codexでは、ツール呼び出しのデフォルトのタイムアウトは60秒です。ある場所の1年分のアーカイブを初めてリクエストすると、Meteosourceに365件のリクエストが送信され、60秒を超えることがあります。そのため、このサーバーのタイムアウトを延長してください。

tool_timeout_sec = 600

ファイルを編集した後は、Codexを再起動してください（アプリでは、MCP serversページのRestartをクリックします）。 codex mcp listで結果を確認でき、セッション中に/mcpを実行すると、接続済みのサーバーが一覧表示されます。

Antigravity

IDEとCLI（agy）は、すべてのプロジェクトで共通の設定ファイル~/.gemini/config/mcp_config.jsonを使うか、プロジェクト内の.agents/mcp_config.jsonを使います。次を追加します。

{
  "mcpServers": {
    "meteosource": {
      "serverUrl": "https://mcp.meteosource.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_METEOSOURCE_API_KEY"
      }
    }
  }
}

キーはそのまま記述されます。Antigravityはこのファイル内の環境変数を展開しません。プロジェクトレベルのファイルを使う場合は、バージョン管理の対象から除外してください。

IDEでは、エージェントパネルからも同じファイルを開けます。…メニューからMCP Servers、Manage MCP Servers、View raw configの順に選択します。CLIでは、/mcpを実行するとMCPマネージャーが開き、接続状態の確認や設定の再読み込みができます。

その他のクライアント

Streamable HTTP経由のMCPに対応するクライアントなら、URLとヘッダーの同じ2つの値で接続できます。また、APIキー用の欄はあっても、ヘッダー全体を入力する欄がないクライアントでは、サーバーはキーをX-API-Key: <key>として受け付けます。

試してみる

• 今週末のブルノの天気は？
• 現在、プラハ、ウィーン、ミュンヘンに気象警報は出ていますか？
• ベルリンの昨年1月の天気を、長期平均と日ごとに比較してください。
• 49.2、16.6の地点で、2025年に風速10 m/sを超えた時間は月ごとに何時間ありましたか？
• クラクフの今後2日間の大気質を、時間ごとに教えてください。
• 南向きの10 kWpの屋根が、50.08、14.43の地点で先週に発電した電力量はいくらですか？（Renewablesプラン）

プランと制限

1つのキーは1つの Meteosource プランに紐づいており、プランによってサーバーが提供する内容が決まります。天気ツールは Free、Startup、Standard プラン向けです。各プランに含まれる内容と、アーカイブをどこまで遡れるかは料金ページをご覧ください。発電ツールには Renewables プランが必要で、このプランでは天気ツールは利用できません。

プランのアーカイブ範囲より古い日付のデータには、Meteosource の過去データアドオンが必要です。アドオンがない場合、API は「not allowed to access historical data this old」というエラーで該当日のリクエストを拒否します。ツールは該当する場所についてこのエラーを報告し、残りの呼び出しは成功するため、プランの範囲内の日付から開始してください。

1回の呼び出しにつき、場所は最大20か所です。時間別のアーカイブと発電データは最大14日分、日別または月別のデータは最大366日分を取得できます。1回の呼び出しで扱える場所日数（場所数 × 日数）は最大400件のため、長期分析には複数回の呼び出しが必要です。場所ごと、またアーカイブまたは発電データの日ごとに、プランのレート制限に従ってキーのリクエストクォータを1件消費します。サーバーはキャッシュを保持するため、短時間のうちに同じ呼び出しを繰り返しても、通常はほとんど、またはまったくクォータを消費しません。キャッシュデータは一定時間が経過すると消去されるため、時間をおいて再度呼び出すと、再びクォータを消費します。

エージェントが受け取るデータ

時系列データはテーブル形式で返されます。columnsは1回だけ返され、rowsは配列として返されます。ネストされたフィールドはフラット化されます（wind_speed、probability_storm、cloud_cover_total）。これは生のAPIデータよりトークン数が4〜7分の1になります。1週間分の時間別予報は約12 kB、1年分の日別アーカイブは約16 kBです。エージェントが少数のフィールドしか必要としない場合は、variablesパラメーターでさらにデータを絞り込めます。単位は各場所の現地の慣習に従います。units="metric"を指定するとSI単位が適用されます。

キーとデータについて

• キーは、お客様に代わって Meteosource を呼び出す場合にのみ使用されます。キー全体が保存されることはなく、URL に表示されることもありません。
• キャッシュはキーごとに保持されます。あるキーで取得したデータが、別のキーに提供されることはありません。
• サービスの運用のため、サービスは呼び出しの発生、使用されたツール、その結果を記録します。
• HTTPS のみを使用します。平文 HTTP によるリクエストは拒否されるため、誤ってキーが暗号化されずに送信されることはありません。

トラブルシューティング

キーがなくてもツールはクライアントに表示されますが、ツールの呼び出しにはキーが必要です。呼び出しが失敗すると、エージェントにはお客様に提示できるメッセージが返されます。

エージェントの報告	対処方法
"No Meteosource API key was supplied…"	ヘッダーが届いていません。名前と、値がBearer （末尾にスペースあり）で始まっていることを確認してください。
"Meteosource does not know this API key…"	キーが誤っているか、失効しています。アカウントから再度コピーしてください。
"This Meteosource API key is disabled…" (or blocked, revoked)	Meteosource サポートにお問い合わせください。
"This API key is on the 'standard' tier, which has no production endpoints…"	発電ツールには Renewables プランが必要です。
"This API key is on the 'renewables' tier, which has only the production endpoints…"	天気ツールには天気プランが必要です。
"Meteosource cannot verify this API key right now…"	Meteosource のキーサービスから応答がありませんでした。数分後にもう一度お試しください。
"Meteosource request quota exceeded for this API key…"	期間内のプランのリクエストクォータを使い切っています。
場所について "not allowed to access historical data this old" と表示される	この日付はプランのアーカイブ範囲外です。期間を短くするか、過去データアドオンを追加してください。
"This call would need N location-days (limit 400)…"	リクエストを短い期間に分割するか、場所を減らしてください。
クライアントで呼び出しがタイムアウトする	場所日数が多い場合、最初のアーカイブ呼び出しには時間がかかります。クライアントのタイムアウトを延長する（Codex: tool_timeout_sec）か、まず短い期間を指定してください。2回目の実行ではキャッシュから提供されます。

キーやプランに関するご質問は Meteosource サポートにお問い合わせください。サーバー自体については、このリポジトリに issue を作成してください。

このリポジトリについて

このリポジトリには、ホスト型サーバーのドキュメントと、MCP Registry に登録されているエントリーである server.json が含まれています。サーバーは com.meteosource/weather として登録されており、レジストリを参照するクライアントやカタログは、このエントリーからサーバー情報を取得します。サーバー自体は Meteosource で稼働しているため、ここでインストールするものはありません。

ライセンス

MIT。詳細は LICENSE を参照してください。