气象数据MCP服务

WeatherXM PRO MCP Server是一个通过MCP协议提供气象站数据、观测和预测的服务,适用于需要实时或历史气象数据的应用场景。

  • by WeatherXM
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 weatherxm/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
    
  2. 在下面添加WeatherXM PRO MCP服务器配置 mcpServers 对象。

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

  4. 您现在可以在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 许可证