Knmi

@pipeworx/knmi

荷兰国家气象局开放数据——站点观测、全国雷达降水、HARMONIE-AROME 预报批次以及网格化日气候序列——均来自 KNMI Data Platform Open Data API。

属于 Pipeworx——一个连接 AI Agent 与 1882+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其背书，也不是由其发布。

工具

• knmi_datasets(search?, verify?, limit?) — 值得调用的数据集、各自包含的内容、更新频率，以及（实时检查的）最新文件。
• knmi_dataset_files(dataset, version, max_keys?, order_by?, sorting?, begin?, page_token?) — 数据集中的文件，默认按最新优先排序。
• knmi_file_url(dataset, version, filename) — 单个文件的临时签名下载 URL。

身份验证

实际使用无需密钥，但设计上需要密钥。每个端点都需要 Authorization 标头，但 KNMI 在其文档页面上公布了一个共享匿名密钥，此工具包也将其设为默认值，因此调用方无需提供任何内容。可通过 _apiKey 替换为自备的注册密钥。

匿名密钥在全球范围内共享（每分钟 50 次请求，每小时 3000 次），KNMI 会在文档页面列出的到期日轮换该密钥：

• 429 表示触及共享配额，并非服务中断。注册密钥可获得专属的每秒 200 次请求额度。
• 401/403 表示公布的密钥已轮换——请阅读 https://developer.dataplatform.knmi.nl/open-data-api 中的“Anonymous key” 部分，并更新 ANON_KEY。工具会明确提示这一点。

可在 https://developer.dataplatform.knmi.nl/ 免费注册。由 Pipeworx 持有的密钥 应命名为 PLATFORM_KNMI_KEY；只有在提交该值的同一变更中，才可在工具包清单中声明 platformKeyEnv，不得提前声明。

下载整个数据集需要另行通过电子邮件向 [email protected] 申请批量密钥。 KNMI 的合理使用政策将激进轮询视为滥用；如需接收新文件推送，请使用其 Notification Service，而不要频繁循环轮询。

数据源

• GET /open-data/v1/datasets/{dataset}/versions/{version}/files — 文件列表。
• GET /open-data/v1/datasets/{dataset}/versions/{version}/files/{filename}/url — 签名下载 URL。
• 文档：https://developer.dataplatform.knmi.nl/open-data-api

注意事项：

• 没有 /datasets 列表端点——调用会返回 404。knmi_datasets 提供的是精选注册表，并会实时验证每个条目，因此已停用的数据集会报告为已停用，而不是直接消失。
• 身份验证在路由之前检查，因此未知路径也会返回 401。没有密钥就无法探测路由表。
• 数据集名称是不透明的，版本以字符串表示（"1.0"、"2"、"5"）。
• Actuele10mindataKNMIstations/2 仍会响应，但已停止接收文件； 10-minute-in-situ-meteorological-observations/1.0 已取代它。最新文件时间戳过旧是唯一的提示，因此请使用 verify。
• 文件是科学数据二进制文件（NetCDF、HDF5、tar 中的 GRIB），不是 JSON。HARMONIE 预报批次每个为 1–3 GB。
• 数据集停用前，响应可能会包含 X-KNMI-Deprecation 标头。

已验证

2026-09-17 — 已实时验证 11 个数据集；雷达合成产品列表和签名下载 URL 均通过公布的匿名密钥返回了真实数据。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "knmi": {
      "url": "https://gateway.pipeworx.io/knmi/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/knmi/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出该工具包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是判断某一天实际范围的权威依据。

这是有意为之，并非意外的多路复用。这些元工具可以让限定范围的连接回答该工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——而无需你再添加第二个 MCP 服务。目前无法在不加载这些元工具的情况下挂载工具包端点；如果额外的 schema 占用的上下文超过路由带来的价值，请连接完整网关一次，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接获取每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和同一组 1882+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/knmi_datasets \
  -H 'Content-Type: application/json' \
  -d '{"search":"radar"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/knmi_datasets。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返：

{
  "mcpServers": {
    "knmi": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-knmi"]
    }
  }
}

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-knmi

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。相同的源代码和工具，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不必直接调用工具——此方式既适用于上述工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Knmi data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT