Weatherxm PRO

🚀 WeatherXM PRO MCP 服务器

WeatherXM PRO MCP 服务器实现了 WeatherXM PRO API 作为 MCP 工具，允许客户端通过 MCP 协议访问天气站数据、观测和预报，为用户提供便捷的天气信息服务。

✨ 主要特性

• 站点查询
  • 获取位置附近的站点（纬度，经度，半径）
  • 在边界框内获取站点（最小/最大纬度和经度）
  • 获取所有可用站点
• 观测数据获取
  • 获取特定站点的最新观测
  • 获取特定日期特定站点的历史观测
• H3 单元格相关
  • 按区域名称搜索 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.