Weather

天气——当前状况和预报

任意地点的当前天气和未来 7–10 天预报。数据由 Open-Meteo（https://open-meteo.com）提供，这是一个免费的国家气象机构数据聚合平台（美国的 NOAA、德国的 DWD 等）。返回温度、湿度、风力、降水和天气状况。免费，无需认证或 API 密钥。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1684+ 个实时数据源的 MCP 网关。

这对 AI Agent 为何重要

Agent 经常需要了解天气信息——用于旅行规划、农业问题、能源需求分析、活动规划、房地产判断（“这个市场是否位于洪水区，且正遭受洪水？”）。Open-Meteo 是合适的后端：免费、准确、全球覆盖，无需折腾密钥。

常见工作流：

• 当前天气状况。“东京现在的天气” → get_weather({location: "Tokyo"}) → 温度、湿度、风力、天气状况。
• 天气预报。“丹佛未来 7 天的天气预报” → get_forecast({location: "Denver"}) → 每日最高/最低温度、降水概率。
• 按坐标查询。 对于无法通过名称准确地理编码的地点，使用 get_weather({latitude: 39.74, longitude: -104.99})。

认证

无需认证。Open-Meteo 免费且无需身份验证。使用限制宽松，遵循合理使用原则（每个 IP 每天约 10,000 次请求）。Pipeworx 会在较短时间内按地点缓存数据，因此重复调用不会消耗每日配额。

地理编码

location 参数接受：

• 城市名称（"Tokyo"、"London"、"Denver"）
• 城市 + 国家/地区（"Paris, France"，以区别于美国德克萨斯州的巴黎）
• ZIP/邮政编码（美国使用 "94070"，英国使用 "SW1A 1AA"）
• 将坐标作为单独的 latitude + longitude 参数传入

对于含义模糊的名称，工具会返回消歧提示。对于特殊地点或需要精确定位的查询（离岸、偏远地区），请直接传入坐标。

更新频率

数据	刷新频率
当前天气状况	约 10 分钟
逐小时预报（未来 24 小时）	每 1–3 小时
每日预报（未来 1–10 天）	每 6 小时

Pipeworx 使用 10 分钟 TTL 缓存数据，因此在此时间段内重复调用的成本很低。

常见问题

• 时区。 预报时间默认使用 UTC。工具也会返回地点的时区——向用户显示时，请在客户端转换时间。
• 降水概率与降水量。“70% 的降雨概率”和“预计降水量为 0.4 英寸”是不同的字段。对于农业和旅行用途，两者都很重要；请同时报告。
• 预报准确性会随日期推远而下降。 第 1 天的预报较可靠；第 7 天及之后的预报只是“天气趋势信号”。不要把 10 天预报当作确定性预测来引用。
• 恶劣天气事件。 Open-Meteo 提供灾害字段，但对于美国而言，其可靠性不如 NWS 的实时预警。对于处理恶劣天气的 Agent，可叠加 NOAA NWS API。
• 历史天气。 默认工具提供当前和未来天气。若需历史数据（昨天及更早），Open-Meteo 提供单独的端点——如有需要，请通过 pipeworx_feedback 告知团队。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/weather/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 都连接到同一个网关和相同的 1684+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都可以访问所有工具包。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/get_weather \
  -H 'Content-Type: application/json' \
  -d '{"latitude":40.7128,"longitude":-74.006}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/get_weather。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

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

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

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

npx -y @pipeworx/mcp-weather

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

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT