Weatherxm PRO

🚀 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、RooCode、ClineなどのMCPクライアントで一般的に使用される設定です。

{
  "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サーバーを使用するには、以下の手順に従ってください。

1. ~/Library/Application Support/Claude/claude_desktop.jsonにある設定ファイルを編集します。
2. mcpServersセクションにweatherxm-proエントリを追加または変更し、上記のJSON設定を参照してください。

Cursor

Cursorでは、以下の設定を行います。

1. ターミナルを開き、以下のコマンドを実行します。

   npm install weatherxm-pro-mcp --save-dev
   

2. package.jsonのスクリプトセクションを更新し、起動コマンドを追加します。

   "scripts": {
     "mcp-server": "weatherxm-pro-mcp start"
   }
   

3. MCPサーバーを起動します。

   npm run mcp-server
   

Windsurf Editor

Windsurf Editorを設定するには、以下の手順に従ってください。

1. 最新バージョンのWindsurf Editorをダウンロードしてインストールします。
2. ソフトウェアを開き、設定メニューに移動します。
3. MCPサーバーセクションに新しいサーバーエントリを追加し、以下の情報を入力します。
   • 名前：weatherxm-pro
   • タイプ：MCP Server
   • アドレス：http://localhost:3000（ポートが3000の場合）
4. 保存してソフトウェアを再起動します。

VSCode

VSCodeでは、以下の設定を行います。

1. 拡張機能「RooCode」をインストールします。
2. 設定を開きます（ショートカット：Ctrl + ,）。
3. 検索バーにmcp.serversを入力し、関連する設定項目を見つけます。
4. 新しいサーバーエントリを追加します。
   • 名前：weatherxm-pro
   • タイプ：MCP Server
   • 位置：http://localhost:3000
5. 保存してウィンドウを再読み込みします。

Dockerの設定

Dockerを使用してMCPサーバーを実行するには、以下のコマンドを実行します。

docker build -t weatherxm-pro-mcp .
docker run -p 3000:3000 --env WEATHERXMPRO_API_KEY=your_api_key weatherxm-pro-mcp

🔧 トラブルシューティング

1. APIキーの確認：環境変数WEATHERXMPRO_API_KEYが正しく設定されていることを確認してください。
2. ポートの競合：ポートが使用中の場合は、サーバーが実行されるポートを変更してみてください。
3. 依存関係の問題：すべてのnpmパッケージが正しくインストールされていることを確認し、必要に応じてnpm installを再度実行してください。

📄 ライセンス

MIT License

Copyright (c) 2023 WeatherXM PRO

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.