关键词

天气数据气象预报气象站点API接口

项目简介

这是一个Model Context Protocol (MCP) 服务器实现，它将 WeatherXM PRO 的 API 接口封装为 MCP 工具，使得兼容 MCP 的大型语言模型 (LLM) 客户端能够访问 WeatherXM PRO 的气象站点数据、观测数据和天气预报等信息。

主要功能点

该服务器暴露了以下与 WeatherXM PRO API 对应的功能：

  • 按位置查询站点: 根据经纬度和半径获取附近的站点信息。
  • 按边界盒查询站点: 获取指定矩形地理区域内的站点信息。
  • 获取所有可用站点: 获取 WeatherXM 网络中所有可用的气象站点列表。
  • 获取站点最新观测: 获取特定气象站的最新天气观测数据。
  • 获取站点历史观测: 获取特定气象站在指定日期的历史观测数据。
  • 按区域名搜索H3单元格: 根据地区名称搜索对应的 H3 地理网格单元。
  • 获取H3单元格内站点: 获取特定 H3 单元格内的气象站点列表。
  • 获取H3单元格天气预报: 获取特定 H3 单元格在指定日期范围内的天气预报（支持按天或按小时）。
  • 获取站点超本地化预报: 获取特定站点和变量的超本地化天气预报。
  • 获取站点预测表现 (FACT): 获取特定站点和变量的预报准确性表现数据。
  • 获取站点预测排名 (FACT): 获取特定站点的预报准确性排名。

安装步骤

  1. 先决条件: 确保您的系统已安装 Node.js 和 npm。同时，您需要一个有效的 WeatherXM PRO API Key。
  2. 克隆仓库: 将项目仓库克隆到您的本地机器。 
    git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git
  3. 进入项目目录: 
    cd weatherxm-pro-mcp
  4. 安装依赖: 安装项目所需的所有依赖包。 
    npm install
  5. 构建项目: 运行构建命令生成可执行文件。 
    npm run build

服务器配置

要在 MCP 客户端中使用此服务器，您需要将以下配置信息添加到您的 MCP 客户端的服务器配置中。具体的配置方式取决于您使用的 MCP 客户端（如 Claude Desktop, Cursor, Windsurf Editor 等），通常是在客户端的设置或配置文件中添加一个新的 MCP 服务器条目。

配置时主要需要提供以下信息：

  • 服务器名称 (Server Name): 给这个服务器起一个在客户端中显示的名称，例如 'weatherxm-pro'。
  • 启动命令 (Command): 客户端将执行的命令，用于启动 MCP 服务器进程。例如，如果您在构建后希望直接运行 Node.js 脚本，命令可能是 'node'。如果您使用 'npx' 启动，命令就是 'npx'。
  • 启动参数 (Args): 传递给启动命令的参数。这通常是服务器代码的路径或包名。例如，如果使用 'node' 命令，参数可能是构建后入口文件的路径，如 '/path/to/your/cloned/repo/dist/index.js'。如果您使用 'npx'，可能需要根据 README 提供的示例填写参数。
  • 环境变量 (Environment Variables): 服务器运行所需的环境变量。对于此服务器，必须设置 'WEATHERXMPRO_API_KEY' 环境变量，其值为您的 WeatherXM PRO API Key。

请查阅您使用的 MCP 客户端的文档，了解如何在其中添加和配置自定义 MCP 服务器。

基本使用方法

配置完成后，重新启动您的 MCP 客户端。在客户端与大型语言模型交互时，您可以通过提问来利用 WeatherXM PRO MCP 服务器提供的能力。LLM 会识别出需要调用外部工具来回答您的请求，并利用服务器提供的工具访问 WeatherXM PRO 数据。

例如，您可以尝试询问：

  • "请查询我当前位置（或指定经纬度）附近的气象站点有哪些？"
  • "告诉我某个气象站（需要提供站点ID）的最新天气观测数据。"
  • "获取某个H3单元格（需要提供H3索引）未来几天的天气预报。"

LLM 将根据您的问题，选择并调用对应的 WeatherXM PRO MCP 工具来获取信息，然后组织答案呈现给您。

信息

分类

网页与API

访问项目