天气 MCP
面向 Claude、Cursor、VS Code 等 AI 客户端的标准化气象能力调用，19 项天气能力覆盖实况、预报、预警、空气质量、分钟降水、节日天气及高阶专项数据。
将华风爱科专业气象数据接入 AI 助手。配置 JSON 与环境变量后，AI 可直接回答天气问题——无需手写 HTTP 请求，也无需单独维护 REST 调用逻辑。
高阶 JV Key 需联系商务申请：business@weathercn.com · 010-64182655
接入后，AI 可直接处理
- 北京今天天气怎么样？
- 上海未来 3 天会下雨吗？
- 深圳现在空气质量如何？
- 明天适合去爬山吗？
- 杭州有没有气象预警？
Key 体系
天气 MCP 支持标准版 openAPI Key 与高阶版 JV Key 两套鉴权模式，通过环境变量自动切换，无需手动改代码。
标准版 · openAPI Key
在「应用管理」获取，与 REST API 共用配额（实名认证后开通 30 天试用，500 次/天，5 QPS）。配置 WEATHERCN_OPENAPI_KEY 即可使用 10 个核心 Tool，无需为 MCP 单独申请 Key。
高阶版 · JV Key
联系商务申请，配置 WEATHERCN_API_KEY 与 WEATHERCN_API_SECRET。解锁更长预报时效、台风 / 天文 / 潮汐等 9 个专项 Tool；与 openAPI Key 同时配置时默认走 JV。
快速接入
安装包名：weatherwork-consumer-mcp，需要 Python 3.11+。建议优先使用官方 PyPI 源；若国内镜像报 No matching distribution，通常是镜像未同步或 Python 版本低于 3.11。完整配置片段亦见 实用资料 · MCP 配置参考。
0交给 AI 一键配置
可直接把需求交给 Cursor Agent、VS Code Copilot、Claude 等 AI：让它先确认你使用的客户端，再自动安装 MCP 包、创建 .env.mcp.local 与对应配置文件。控制台产品页提供了更完整的提示词模板。
1安装 MCP 服务
python3 -m pip install weatherwork-consumer-mcp -i https://pypi.org/simple
2配置 Claude Desktop（标准版）
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows 路径见配置参考）
{
"mcpServers": {
"weatherwork": {
"command": "weatherwork-consumer-mcp",
"env": {
"WEATHERCN_OPENAPI_KEY": "your_openapi_key"
}
}
}
}
3配置 Cursor（标准版）
先在项目根目录创建 .env.mcp.local，写入 WEATHERCN_OPENAPI_KEY=your_openapi_key；再在 .cursor/mcp.json 中添加以下配置。
{
"mcpServers": {
"weatherwork": {
"command": "weatherwork-consumer-mcp",
"envFile": "/path/to/.env.mcp.local"
}
}
}
4配置 VS Code / Copilot（标准版）
同样推荐在项目根目录使用 .env.mcp.local；VS Code 使用 servers 字段，而不是 mcpServers。
{
"servers": {
"weatherwork": {
"type": "stdio",
"command": "weatherwork-consumer-mcp",
"envFile": "${workspaceFolder}/.env.mcp.local",
"env": {
"WORKSPACE_FOLDER": "${workspaceFolder}"
}
}
}
}
5高阶版配置（JV Key）
{
"mcpServers": {
"weatherwork": {
"command": "weatherwork-consumer-mcp",
"env": {
"WEATHERCN_API_KEY": "your_jv_api_key",
"WEATHERCN_API_SECRET": "your_jv_api_secret"
}
}
}
}
高阶版 JV Key 需联系商务申请：business@weathercn.com · 010-64182655（工作日 9:30–17:30）
工具能力（共 19 项）
核心 Tool · 标准版（10 个）
resolve_location地名解析与消歧义get_today_weather今日天气聚合：实况 + 逐日 + 今日剩余逐小时get_current_weather实况天气get_weather_forecast逐日预报（1/5/10 天）get_hourly_forecast逐小时预报（最长 72 小时）get_weather_alerts气象预警get_activity_advice生活指数与活动建议get_air_quality空气质量实况get_minute_precipitation分钟级降水（约 2 小时）get_festival_weather节日天气：节前 / 正日 / 节后预报
高阶专项 Tool · JV Key（9 个）
get_typhoon_detail台风路径详情get_typhoon_season_list当年命名台风列表get_typhoon_recent最近台风摘要get_astronomy_daily天文逐日get_astronomy_current天文实况get_astronomy_hourly天文逐小时get_tidal_5day_forecast5 日潮汐预报get_tidal_hourly_forecast逐小时潮汐get_tidal_station潮汐站点查询
标准版 vs 高阶版
| 能力 | 标准版（openAPI Key） | 高阶版（JV Key） |
|---|---|---|
| 实况天气 | 当前实况 | + 过往 6 小时 / 24 小时 |
| 逐日预报 | 1 / 5 / 10 天 | + 25 / 45 / 90 天 |
| 逐小时预报 | 1 / 12 / 24 / 72 小时 | + 120 / 240 / 360 小时 |
| 气象预警 | ✅ | ✅ |
| 空气质量 | 当前实况 | + 逐小时预报(24h) / 全国城市排名 |
| 分钟降水 | 仅中国区域 | 全球覆盖 |
| 生活指数 | 1 天 | + 5 / 10 / 15 天 |
| 节日天气 | ✅ | ✅ |
| 台风 | — | ✅ |
| 天文 | — | ✅ |
| 潮汐 | — | ✅ |
| 地理位置搜索 | ✅ | ✅ |