mcp-meteoblue

一个用 JavaScript 编写的 MCP 服务器，用于访问 meteoblue Weather API。它让 MCP 客户端可以搜索地点、使用 Free Weather API 中可用的包获取天气预报，并请求预报 meteogram 图像。

工具

• search_locations 使用 meteoblue Location Search 解析城市、邮政编码以及 IATA/ICAO 机场代码。

• get_forecast 接受地点名称或坐标，返回预报 JSON；默认返回当前天气、逐小时天气和每日天气。

• get_forecast_image 接受地点名称或坐标，并将预报图像直接返回给 MCP 客户端。

传给 预报或图像工具的地点名称始终通过官方 meteoblue Location Search API 解析。预报包（package）的输入被限制为 Free Weather API 文档中列出的包。

[!NOTE] meteoblue 当前的 Free Weather API 文档指出，图像需要更高级别的访问权限。图像工具符载于具有 Image API 权限的 API 密钥，反之会返回明确的授权错误。

Related MCP server: mcp-weather-server

要求

• Node.js 20 或更高版本

• 一个 meteoblue API 密钥

请保持该密钥私有。此服务器从 METEOBLUE_API_KEY 读取密钥；它绝不会出现在包或 MCP 工具参数中。

通过 npm 运行

将此 stdio 服务器添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "meteoblue": {
      "command": "npx",
      "args": ["-y", "mcp-meteoblue"],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者直接运行：

METEOBLUE_API_KEY=your_api_key_here npx -y mcp-meteoblue

该服务器使用 stdio，因此它在等待 MCP 客户端期间不会产生任何终端常规输出。

Docker

在本地构建镜像：

docker build -t mcp-meteoblue .

在你的 MCP 客户端中配置基于 Docker 的 stdio 服务器：

{
  "mcpServers": {
    "meteoblue": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "METEOBLUE_API_KEY",
        "mcp-meteoblue"
      ],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

容器以非特权 node 用户身份运行。由于 MCP 通信使用 stdio，请使用 -i 保持 stdin 打开。

本地开发

npm install
npm test
METEOBLUE_API_KEY=your_api_key_here npm start

将 MCP 客户端指向 node /absolute/path/to/mcp-meteoblue/src/index.js，并在该客户端的配置中设置环境变量。

发布

GitHub Actions 会在每次 push 和 pull requests 时运行测试套件，并在 Node.js 20、22、24 和 26 上验证 npm tarball。Dependabot 每周检查 npm 依赖和 GitHub Actions 依赖。

推送一个 vnode* git 标签会触发 .github/workflows/publish.yml。该工作流使用 npm trusted publishing（OIDC）并自动附加 provenance。按以下内容配置 npm trusted publisher：

• GitHub 所有者：unixfox

• 仓库：mcp-meteoblue

• 工作流：publish.yml

• 环境：npm

配置 trusted publishing 后，GitHub 中不需要存储任何 npm token。

API 范围

该服务器仅调用以下接口：

• https://www.meteoblue.com/{language}/server/search/query3

• https://my.meteoblue.com/packages/{packages}

• https://my.meteoblue.com/images/{forecast-image-type}

它不暴露 meteoblue History、Dataset、Maps、Measurements 或其他任何 API。

许可证

MIT