WeatherXM PRO MCP

WeatherXM PRO MCP服务器

一个MCP服务器实现，通过MCP工具暴露WeatherXM PRO API，使客户端能够通过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

按照以下步骤使用WeatherXM PRO MCP服务器与Claude Desktop MCP客户端：

1. 编辑位于以下路径的MCP设置文件：

   ~/Library/Application Support/Claude/claude_desktop_config.json

1. 在下面添加WeatherXM PRO MCP服务器配置 mcpServers 对象。

1. 重启Claude桌面版以应用更改。

1. 您现在可以在Claude Desktop中使用服务器，在WeatherXM PRO MCP服务器上运行查询。

光标

按照以下步骤使用Cursor连接WeatherXM PRO MCP服务器：

1. 安装 光标 在你的机器上。
2. 在Cursor中，依次点击Cursor > Cursor设置 > MCP > 添加新的全局MCP服务器。
3. 指定与“MCP客户端服务器配置”部分中相同的配置。
4. 保存配置。
5. 在MCP服务器列表中，你会看到weatherxm-pro作为一个已添加的服务器。
6. 您现在可以在 Cursor 中使用 WeatherXM PRO MCP 服务器来运行查询。

风帆编辑器

按照以下步骤使用WeatherXM PRO MCP服务器 风帆编辑器根据上面的信息，执行如下指令：

1. 在您的机器上安装Windsurf编辑器。
2. 导航至命令面板 > Windsurf MCP配置面板 或 Windsurf - 设置 > 高级 > 级联 > 模型上下文协议 (MCP) 服务器。
3. 点击“添加服务器”，然后点击“添加自定义服务器”。
4. 从“MCP客户端服务器配置”部分中添加WeatherXM PRO MCP服务器配置。
5. 保存配置。
6. 在MCP服务器列表中，你会看到weatherxm-pro作为新增的服务器。
7. 您现在可以在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 许可证