WeatherXM PRO MCP Server

WeatherXM PRO MCP 服务

一个 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 客户端的服务配置

以下配置适用于 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 服务：

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

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

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

3. 重启 Claude Desktop 以应用更改。

4. 现在可以在 Claude Desktop 中使用该服务，向 WeatherXM PRO MCP 服务发送查询。

Cursor

按照以下步骤在 Cursor 中使用 WeatherXM PRO MCP 服务：

1. 在计算机上安装 Cursor。
2. 在 Cursor 中，前往 Cursor > Cursor Settings > MCP > Add a new global MCP server。
3. 指定与“MCP 客户端的服务配置”部分相同的配置。
4. 保存配置。
5. 你会在 MCP 服务列表中看到已添加的 weatherxm-pro。
6. 现在可以在 Cursor 中使用 WeatherXM PRO MCP 服务发送查询。

Windsurf Editor

按照以下步骤在 Windsurf Editor 中使用 WeatherXM PRO MCP 服务：

1. 在计算机上安装 Windsurf Editor。
2. 前往 Command Palette > Windsurf MCP Configuration Panel 或 Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers。
3. 点击 Add Server，然后点击 Add custom server。
4. 添加“MCP 客户端的服务配置”部分中的 WeatherXM PRO MCP 服务配置。
5. 保存配置。
6. 你会在 MCP Servers 列表中看到已添加的 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 许可证