Weatherxm PRO

🚀 WeatherXM PRO MCP 服務器

WeatherXM PRO MCP 服務器實現了 WeatherXM PRO API 作為 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 客戶端配置

這是 MCP 客戶端（如 Claude Desktop、Cursor、Windsurf Editor、VSCode 以及 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 服務器：

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.