WeatherXM PRO MCP Server

这是一个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以及RooCode和Cline等插件的MCP客户端的通用配置。

{
  "mcpServers": {
    "weatherxm-pro": {
      "command": "npx",
      "args": [
        "-y",
        "mcp路径"
      ],
      "env": {
        "WEATHERXMPRO_API_KEY": "你的API密钥"
      }
    }
  }
}

将"mcp路径"替换为实际的MCP服务器路径或包名，并将"你的API密钥"替换为您的WeatherXM PRO API密钥。

注意：如果您已经在客户端使用其他MCP服务器，可以将其添加到现有的mcpServers对象中。

Claude Desktop

按照以下步骤使用WeatherXM PRO MCP服务器与Claude Desktop 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

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

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

Windsurf Editor

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

1. 在您的机器上安装Windsurf Editor。
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="你的API密钥" -e PORT=3300 weatherxm-pro-mcp

将"你的API密钥"替换为您的实际WeatherXM PRO API密钥。

故障排除提示

• 确保配置中的MCP服务器仓库路径正确。
• 验证您的WeatherXM PRO API密钥是否设置正确。
• 检查MCP客户端配置是否与服务器设置匹配。
• 查看日志是否有任何错误或警告，这些可能表明MCP服务器存在问题。

许可证

MIT许可证