# weather-mcp — 中文天气/空气质量 MCP Server
## 演示

![操作演示](assets/demo_usage.gif)

![功能总览](assets/demo_features.png)

> 当前天气 + 未来预报 + 空气质量一体查询。**免 key、免注册**（Open-Meteo）。
> 中文城市名模糊解析（"北京"/"上海市"都能识别）。

## 为什么做这个

- **"天气+空气质量"组合 MCP = 零竞品**（调研确认）
- 现有中文天气 MCP 最高才 21★，质量差（依赖高德/和风 key）
- 中文城市名模糊解析（AI 常答错城市坐标）是差异化

## 核心能力

| 工具 | 说明 |
|---|---|
| `current_weather` | 当前天气：温度/体感/湿度/风速/降水概率/天气状况 |
| `weather_forecast` | 未来 N 天预报（最高/最低温+降水+天气） |
| `air_quality` | 空气质量：PM2.5/PM10/CO/NO2/SO2/O3 + AQI估算+等级 |
| `weather_all` ⭐ | 天气+空气一体查询（一次调用全部） |

## 数据源

- **Open-Meteo**（免 key）：全球含中国，天气 + 空气质量（CAMS模型）
- **内置 10 个高频城市**（北京/上海/广州/深圳等）避免 geocoding 偶发失败
- 城市名自动缓存

## 安装

```bash
pip install weather-mcp-server
```

## 使用

```json
{
  "mcpServers": {
    "weather": {
      "command": "weather-mcp",
      "args": []
    }
  }
}
```

## 示范

```
weather_all(city="深圳")
→ 当前22.8°C阴 + 3天预报（最高30°C）+ PM2.5空气质量
```

## License

MIT。

---

## 系列（Chinese MCP Suite）

> 中文内容创作/工具 MCP 全家桶，全本地、CPU、离线：


- [tts-mcp-server](https://github.com/Gollum-code/tts-mcp-server) — TTS聚合+字幕对齐
- [idphoto-mcp](https://github.com/Gollum-code/idphoto-mcp) — 本地证件照
- [audio-post-mcp](https://github.com/Gollum-code/audio-post-mcp) — 音频后期
- [video-workflow-mcp](https://github.com/Gollum-code/video-workflow-mcp) — 视频工作流
- [poetry-mcp](https://github.com/Gollum-code/poetry-mcp) — 古诗文
- [script-mcp](https://github.com/Gollum-code/script-mcp) — 口播文案
- [asset-mcp](https://github.com/Gollum-code/asset-mcp) — 素材库
- [idiom-mcp](https://github.com/Gollum-code/idiom-mcp) — 成语典故
- **weather-mcp**（本仓库）— 天气/空气