Dwd Climate

@pipeworx/dwd-climate

来自德国国家气象局（Deutscher Wetterdienst，DWD）气候数据中心的每日气候观测数据：覆盖约 1,400 个现役和已关闭站点，包含温度、降水、日照、积雪深度、风、湿度、气压和云量，并附带 DWD 质量标记。数据从各站点的首条记录（部分可追溯至 19 世纪）持续更新至昨天。

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

工具

• dwd_stations(name? | lat+lon, active_only?, limit?) — 按名称（可省略变音符号）查找站点，或查找距离指定坐标最近的站点；返回站点 ID、联邦州、海拔、坐标以及首条和末条观测日期。
• dwd_daily(station_id, from?, to?) — 返回某个站点在指定日期范围内的逐日观测数据（每次调用最多 1000 天；截断时返回 next_from），包含单位和质量等级。
• dwd_latest(station_id) — 返回某个站点最近的每日观测数据，通常为昨天的数据。

每个响应都包含 source、attribution 和 data_as_of（提供所用上游文件的 Last-Modified 时间）。不存在的站点编号、没有匹配结果的名称，或没有观测数据的日期范围，都会返回带有 data_as_of 的 found: false，而不会返回空数组。上游故障会抛出异常。

身份验证

无需密钥。

数据来源

• 德国气象局（Deutscher Wetterdienst，DWD）气候数据中心——德国站点的每日气候观测（KL），数据存于两个档案中：每日更新的近期档案（约含最近 500 天的数据）和经过质量控制的历史档案（从各站点的首条记录到上一完整年份结束），以及 DWD 的站点描述列表。

每次调用只会实时读取所需的单个站点数据。日期范围跨越两个档案时，同一天的数据若在两个档案中都有，则采用历史档案（经过质量控制）的值；archives_read 会说明使用了哪些档案。

复用条款

DWD 气候数据中心使用条款（截至 2024 年 5 月），全文引用：

适用知识共享署名 4.0 许可协议“CC BY 4.0”。详情请参阅 https://www.dwd.de/copyright

每个响应都包含署名信息（“来源：Deutscher Wetterdienst”）。

字段说明

• 站点 ID 为 5 位数字，不足位数时以零补齐；工具接受带或不带前导零的 ID。
• 上游的 -999 表示缺失，返回为 null。QN_3 是风相关列（FX、FM）的质量等级，QN_4 则适用于其他所有列。
• RSKF（降水形式）是一个代码：0 表示无，1 表示雨，4 表示未知形式，6 表示雨，7 表示雪，8 表示雨和雪，9 表示缺失。
• 许多自动站不报告日照时长（SDK）；此处的 null 是上游数据所致，并非解析失败。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/dwd-climate/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和其余整个网关通用的工具集。因此，你看到的工具数量会多于此表：单个工具包端点目前会列出大约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围，也是当天情况的权威答案。

这是有意为之，并非意外地进行了多路复用。元工具让范围受限的连接能够回答此工具包未涵盖的问题——通过可跨整个目录路由的 ask_pipeworx 实现——而无需添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义占用的上下文超出了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1878+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/dwd_stations \
  -H 'Content-Type: application/json' \
  -d '{"name":"Dresden","limit":5}'

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

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

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

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

或者直接运行它，以确认其能够启动：

npx -y @pipeworx/mcp-dwd-climate

它通过 stdin/stdout 使用 MCP 协议，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所添加的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以不用直接调用工具，而是用日常语言提问——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Dwd Climate data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT