# 彩云天气

查询实时天气、逐小时预报、空气质量与天气预警。

- 类型：MCP
- 权限：只读查询
- 门槛：需 API Key
- 官方入口：https://github.com/caiyunapp/mcp-caiyun-weather
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/caiyun-weather/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。

## 接入前准备

需彩云天气开发者 API Key；接口额度、天气权限和费用以平台账号为准。

## 接入步骤

1. 在彩云天气开发者平台注册并申请 API Key。 [官方入口](https://github.com/caiyunapp/mcp-caiyun-weather)
2. 按官方远程服务配置，把 Key 填到 X-Caiyun-API-Key 请求头。 [官方入口](https://github.com/caiyunapp/mcp-caiyun-weather)

## 验证方法

查询一个公开地点的天气，核对位置和时间；调用前确认剩余额度。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://github.com/caiyunapp/mcp-caiyun-weather)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "caiyun-weather": {
      "type": "http",
      "url": "https://mcp-weather.caiyunapp.com/mcp",
      "headers": {
        "X-Caiyun-API-Key": "${CAIYUN_WEATHER_X_CAIYUN_API_KEY}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --header 'X-Caiyun-API-Key: ${CAIYUN_WEATHER_X_CAIYUN_API_KEY}' --transport http 'caiyun-weather' 'https://mcp-weather.caiyunapp.com/mcp'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.caiyun-weather]
url = "https://mcp-weather.caiyunapp.com/mcp"

[mcp_servers.caiyun-weather.env_http_headers]
"X-Caiyun-API-Key" = "CAIYUN_WEATHER_X_CAIYUN_API_KEY"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

Codex 的 bearer_token_env_var 对应变量只填 Token，不带 Bearer；env_http_headers 对应变量提供完整请求头值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://github.com/caiyunapp/mcp-caiyun-weather)。官方组织 caiyunapp 主页链接彩云官网，组织名称为彩云公司。

官方原文摘录（2026-11-05，来自上述依据）：

```
https://mcp-weather.caiyunapp.com/mcp
```

- [厂商官方接入文档](https://github.com/caiyunapp/mcp-caiyun-weather)
- [厂商官方发布依据](https://github.com/caiyunapp)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)