WeatherXM PRO MCP Server について
WeatherXM PRO MCP Serverは、WeatherXM PRO APIを気象データ用ツールとしてMCPクライアントに提供します。観測所の検索や過去の観測データに加え、H3セルや観測所単位の予報にも対応します。
主な機能
- 01座標や境界ボックスで観測所を検索
- 02最新および過去の観測データを取得
- 03地域名からH3セルを検索
- 04H3セルの毎日または毎時の予報を取得
- 05観測所の局地予報を取得
- 06予報の実績とランキングを確認
活用シーン
- 01指定地域の近くにある観測所を検索
- 02指定日の観測所データを確認
- 03特定のH3セルの予報を取得
MCP 対応
観測所、観測データ、予報に関するWeatherXM PRO API機能をツールとしてMCPクライアントに提供します。利用には有効なWeatherXM PRO APIキーが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
WeatherXM PRO MCP サーバー
WeatherXM PRO API を MCP ツールとして公開する MCP サーバー実装です。クライアントは MCP プロトコルを通じて、気象観測所のデータ、観測値、予報にアクセスできます。
機能
- 位置情報(緯度、経度、半径)の近くにある観測所を取得
- 矩形範囲(最小/最大の緯度と経度)内にある観測所を取得
- 利用可能なすべての観測所を取得
- 指定した観測所の最新の観測値を取得
- 指定した日付の観測所の過去の観測値を取得
- 地域名で H3 セルを検索
- 指定した H3 セル内の観測所を取得
- 指定した H3 セルの気象予報(日次または時間単位)を取得
- 観測所と変数を指定して超局地予報を取得
- 観測所と変数を指定して予報パフォーマンス(FACT)を取得
- 観測所の予報ランキング(FACT)を取得
前提条件
- Node.js と npm がインストールされていること
- 有効な WeatherXM PRO API キー
設定
リポジトリをローカルマシンにクローンします。
git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git
インストール
リポジトリをクローンした後、MCP サーバーを実行する前に依存関係をインストールし、プロジェクトをビルドする必要があります。
npm install
npm run build
MCP クライアントのサーバー設定
これは、Claude Desktop、Cursor、Windsurf Editor、VSCode などの MCP クライアントや、RooCode や Cline などのプラグインに共通する設定です。
{
"mcpServers": {
"weatherxm-pro": {
"command": "npx",
"args": [
"-y",
"path to mcp"
],
"env": {
"WEATHERXMPRO_API_KEY": "your-api-key"
}
}
}
}
"path to mcp" を MCP サーバーまたはパッケージの実際のパスに、"your-api-key" を WeatherXM PRO API キーに置き換えてください。
注:クライアントでほかの MCP サーバーを使用している場合は、既存の
mcpServersオブジェクトに追加できます。
Claude Desktop
Claude Desktop MCP クライアントで WeatherXM PRO MCP サーバーを使用するには、以下の手順に従ってください。
-
次の場所にある MCP 設定ファイルを編集します。
~/Library/Application Support/Claude/claude_desktop_config.json -
mcpServersオブジェクトの下に WeatherXM PRO MCP サーバーの設定を追加します。 -
Claude Desktop を再起動して変更を適用します。
-
Claude Desktop でサーバーを使用して、WeatherXM PRO MCP サーバーにクエリを実行できるようになります。
Cursor
Cursor で WeatherXM PRO MCP サーバーを使用するには、以下の手順に従ってください。
- Cursor をマシンにインストールします。
- Cursor で、Cursor > Cursor Settings > MCP > Add a new global MCP server の順に移動します。
- 「MCP クライアントのサーバー設定」セクションと同じ設定を指定します。
- 設定を保存します。
- MCP サーバーの一覧に weatherxm-pro が追加されたことを確認します。
- Cursor で WeatherXM PRO MCP サーバーを使用して、クエリを実行できるようになります。
Windsurf Editor
Windsurf Editor で WeatherXM PRO MCP サーバーを使用するには、以下の手順に従ってください。
- Windsurf Editor をマシンにインストールします。
- Command Palette > Windsurf MCP Configuration Panel、または Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers に移動します。
- Add Server をクリックし、次に Add custom server をクリックします。
- 「MCP クライアントのサーバー設定」セクションにある WeatherXM PRO MCP サーバーの設定を追加します。
- 設定を保存します。
- MCP Servers の一覧に weatherxm-pro が追加されたことを確認します。
- Windsurf Editor で WeatherXM PRO MCP サーバーを使用して、クエリを実行できるようになります。
Docker イメージ
MCP サーバーは Docker コンテナとしてビルドして実行できます。
ビルド
docker build -t weatherxm-pro-mcp .
実行
docker run -d -p 3000:3000 -e WEATHERXMPRO_API_KEY="your-api-key" -e PORT=3000 weatherxm-pro-mcp
"your-api-key" を実際の WeatherXM PRO API キーに置き換えてください。
トラブルシューティングのヒント
- 設定内の MCP サーバーリポジトリへのパスが正しいことを確認してください。
- WeatherXM PRO API キーが正しく設定されていることを確認してください。
- MCP クライアントの設定がサーバー設定と一致していることを確認してください。
- MCP サーバーの問題を示すエラーや警告がないか、ログを確認してください。
ライセンス
MIT ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。