Weather MCP Server by Meteosource

Meteosource 天气 MCP 服务

面向 AI Agent 的天气数据。Meteosource 托管的服务地址为

https://mcp.meteosource.com/mcp

它通过 Streamable HTTP 使用 Model Context Protocol。将它连接到 Claude Code、Claude Desktop、Codex、Antigravity 或任何其他 MCP 客户端，在请求头中发送你的 Meteosource API 密钥， Agent 就能查询天气预报、官方天气预警、空气质量、过去 20 年的历史天气，以及光伏系统和风电场的发电量。

无需安装，也无需托管。服务本身不保存任何密钥：每个请求都使用随请求发送的密钥，并遵循该密钥所属套餐的限制。

工具

工具	功能
search_places	将地点名称、邮政编码或坐标转换为其他工具所需的 place_id
get_forecast	一次调用可查询最多 20 个地点的当前天气状况、逐小时（最多 168 h）和逐日（最多 30 天）天气预报、逐分钟降水信息及预警；使用 variables 筛选器可缩短回答
get_alerts	查询最多 20 个地点的官方恶劣天气预警；仅返回有预警的地点。覆盖美国、欧盟和加拿大
get_weather_history	查询过去天气：逐小时数据（每次调用最多 14 天）、逐日或逐月数据（每次调用最多 366 天），由服务端汇总。normals=true 会添加长期气候平均值和极值记录；wind_distribution 会提供各风速区间的小时数，用于风机选址
get_air_quality	查询未来约 4 天的逐小时空气质量：指数、PM10、PM2.5、NO₂、SO₂、O₃ 等
get_solar_production	根据光伏系统的位置、组件和逆变器功率、倾角及朝向，查询其输出：每小时功率、每日或每月发电量，时间范围为过去 20 年至未来 4 天
get_wind_production	根据风电场的位置、风机型号、数量或容量、轮毂高度及地形，查询其输出：每小时功率、每日或每月发电量，时间范围为过去 20 年至未来 4 天

服务会告知 Agent 各工具的配合方式，因此，像“明天布尔诺会下雨吗”这样的问题会先调用 search_places，再调用 get_forecast，无需你明确说明这一步骤。

连接前的准备

你需要一个 Meteosource API 密钥。在 meteosource.com 注册（免费套餐足以试用天气预报工具），然后从账户中复制密钥。

每个请求都会通过 Authorization 请求头携带密钥，格式为 Bearer <key>。以下每种配置都只需两个值：上面的 URL 和该请求头。

其余部分由服务自行处理。它会向 Meteosource 查询密钥所属的套餐，并提供该套餐包含的工具；如果某个工具不在套餐内，服务会用一句话说明。请参阅 套餐与限制。

连接

Claude Code

只需一条命令：

claude mcp add --transport http meteosource https://mcp.meteosource.com/mcp \
  --header "Authorization: Bearer YOUR_METEOSOURCE_API_KEY"

此命令会为当前项目注册服务。添加 --scope user 即可让所有项目都能使用。运行 claude mcp list 可查看是否已连接；在会话中输入 /mcp 可列出工具。

如需与团队共享配置但不共享密钥，请将 .mcp.json 提交到项目根目录，并让每位成员将自己的密钥保存在环境变量中：

{
  "mcpServers": {
    "meteosource": {
      "type": "http",
      "url": "https://mcp.meteosource.com/mcp",
      "headers": {
        "Authorization": "Bearer ${METEOSOURCE_API_KEY}"
      }
    }
  }
}

Claude Desktop 和 claude.ai

连接器关联到你的帐户，因此，在网页端添加的连接器也会出现在桌面应用中，反之亦然。

1. 打开 Customize > Connectors（在桌面应用中：Settings > Connectors），然后点击 Add custom connector。
2. 将其命名为 Meteosource；URL 为 https://mcp.meteosource.com/mcp。
3. 在 Authentication 下选择 No sign-in。
4. 在 Request headers 下添加 Authorization，值为 Bearer YOUR_METEOSOURCE_API_KEY。请自行输入单词 Bearer 和空格：Claude 会原样发送你输入的值。
5. 点击 Add。在聊天中打开 + 菜单，选择 Connectors，然后启用 Meteosource。

在 Team 和 Enterprise 计划中，所有者可在 Organization settings > Connectors 下添加连接器，成员则可从 Customize > Connectors 连接该连接器。免费计划允许添加一个自定义连接器。

Codex

Codex CLI、Codex 应用和 IDE 扩展都读取同一个文件 ~/.codex/config.toml，因此只需配置一次服务即可供这三者使用。在终端中运行：

codex mcp add meteosource --url https://mcp.meteosource.com/mcp \
  --bearer-token-env-var METEOSOURCE_API_KEY

并在 shell 配置文件中导出 METEOSOURCE_API_KEY。此操作写入文件的部分内容：

[mcp_servers.meteosource]
url = "https://mcp.meteosource.com/mcp"
bearer_token_env_var = "METEOSOURCE_API_KEY"

Codex 应用有自己的对话框（Settings > MCP servers > Add server，类型选择 Streamable HTTP），但没有用于填写密钥的字段。如果应用显示服务连接失败，说明它没有获取到环境变量：从 Dock 或“开始”菜单启动的应用无法读取你在终端中导出的变量。请改为将密钥写入文件：

[mcp_servers.meteosource]
url = "https://mcp.meteosource.com/mcp"
http_headers = { Authorization = "Bearer YOUR_METEOSOURCE_API_KEY" }

Codex 默认给工具调用 60 秒的时间。对某个地点请求一整年的历史数据时，会向 Meteosource 发送 365 个请求，可能耗时更久，因此请为此服务设置更长的超时时间：

tool_timeout_sec = 600

编辑文件后重启 Codex（在应用中，前往 MCP servers 页面并点击 Restart）。 codex mcp list 会显示结果；在会话中使用 /mcp 可查看已连接的服务。

Antigravity

IDE 和 CLI（agy）共用一个配置文件：所有项目使用 ~/.gemini/config/mcp_config.json，也可以使用项目内的 .agents/mcp_config.json。添加：

{
  "mcpServers": {
    "meteosource": {
      "serverUrl": "https://mcp.meteosource.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_METEOSOURCE_API_KEY"
      }
    }
  }
}

密钥会以明文写入；Antigravity 不会在此文件中展开环境变量。如果使用项目级文件，请勿将其纳入版本控制。

在 IDE 中，也可以通过 Agent 面板访问同一文件：打开 … 菜单，选择 MCP Servers、 Manage MCP Servers、View raw config。在 CLI 中，使用 /mcp 打开 MCP 管理器，即可查看连接状态并重新加载配置。

其他客户端

任何支持通过 Streamable HTTP 使用 MCP 的客户端，都可以使用相同的两个值：URL 和标头。对于有 API 密钥字段、但没有完整标头字段的客户端，服务也接受 X-API-Key: <key> 形式的密钥。

试试看

• 布尔诺这个周末的天气怎么样？
• 布拉格、维也纳和慕尼黑目前有天气预警吗？
• 按天比较柏林去年 1 月的天气与长期平均值。
• 49.2、16.6 在 2025 年每月有多少小时风速超过 10 m/s？
• 克拉科夫未来两天的空气质量如何？请按小时列出。
• 一个朝南、容量为 10 kWp、位于 50.08、14.43 的屋顶，上周能发多少电？（可再生能源计划）

套餐和限制

一个密钥对应一个 Meteosource 套餐，套餐决定服务提供的内容。天气工具适用于 Free、Startup 和 Standard 套餐；各套餐包含的内容以及档案数据可追溯的时间范围，请参阅定价页面。生产工具需要 Renewables 套餐，而该套餐不提供天气工具。

超出套餐档案数据范围的日期需要使用 Meteosource 的历史数据附加服务。若未启用该服务，API 会以 "not allowed to access historical data this old" 拒绝此类日期；工具会针对相关位置报告该情况，其余调用仍会成功，因此请从套餐范围内的日期开始查询。

每次调用：最多 20 个位置；小时级档案和生产数据最多 14 天，日级或月级数据最多 366 天；每次调用最多 400 个位置日（位置数 × 天数），因此较长的分析需要分多次调用。每个位置以及档案或生产数据中的每一天，都会计入该密钥的配额，并受套餐的速率限制。服务会缓存数据，因此短时间内重复调用通常几乎不会消耗配额，甚至不会消耗配额。缓存数据会在一段时间后清除，因此间隔较长后再次调用会重新计入配额。

Agent 会收到什么

时间序列以表格形式返回：columns 只出现一次，rows 则以数组形式返回，嵌套字段会被扁平化（wind_speed、probability_storm、cloud_cover_total）。与原始 API 相比，这样可减少 4 到 7 倍的令牌用量：一周的逐小时预报约为 12 kB，一年的逐日档案约为 16 kB。如果 Agent 只需要几个字段，variables 参数还能进一步缩减数据。单位默认遵循各位置的当地惯例；units="metric" 会强制使用 SI 单位。

你的密钥和数据

• 你的密钥只用于代表你调用 Meteosource。密钥不会完整存储，也不会出现在 URL 中。
• 缓存按密钥分别保存。为一个密钥获取的数据绝不会提供给其他密钥。
• 服务会记录调用是否发生、使用了哪个工具以及调用结果，以便维护服务。
• 仅支持 HTTPS。通过普通 HTTP 发出的请求会被拒绝，因此不会因操作失误而以明文发送密钥。

故障排查

客户端中无需密钥即可看到这些工具；只有调用工具时才需要密钥。调用失败时，Agent 会收到一条可展示给你的说明。

Agent 报告的内容	处理方法
"No Meteosource API key was supplied…"	请求未包含请求头。请检查请求头名称，并确认值以 Bearer 开头（注意后面的空格）。
"Meteosource does not know this API key…"	密钥输入有误或已撤销。请从你的账户重新复制密钥。
"This Meteosource API key is disabled…"（或 blocked、revoked）	请联系 Meteosource 支持。
"This API key is on the 'standard' tier, which has no production endpoints…"	生产工具需要 Renewables 套餐。
"This API key is on the 'renewables' tier, which has only the production endpoints…"	天气工具需要天气套餐。
"Meteosource cannot verify this API key right now…"	Meteosource 的密钥服务未响应。请几分钟后重试。
"Meteosource request quota exceeded for this API key…"	当前周期内已用完套餐的请求配额。
某个位置显示 "not allowed to access historical data this old"	日期超出套餐的档案数据范围。请缩短日期范围或添加历史数据附加服务。
"This call would need N location-days (limit 400)…"	将请求拆分为较短的日期范围或减少位置数量。
客户端中的调用超时	首次调用涉及多个位置日的档案数据时需要一些时间。请延长客户端超时时间（Codex：tool_timeout_sec），或先请求较短的日期范围；第二次运行会从缓存提供数据。

有关密钥或套餐的问题，请联系 Meteosource 支持。有关服务本身的问题，请在此代码仓库中提交 issue。

关于此代码库

此代码库包含托管服务的文档及其在 MCP Registry 中的条目 server.json。该服务在其中列为 com.meteosource/weather；读取此注册表的客户端和目录会从该条目获取信息。服务本身运行在 Meteosource；这里无需安装任何内容。

许可证

MIT，详见 LICENSE。