全国城市空气质量查询：通过 MCP 在 AI 客户端中直接查询
# 全国城市空气质量查询：通过 MCP 在 AI 客户端中直接查询
> 接口/接入点：全国城市空气质量查询（apiCode=104）· 接口级 MCP · 免费 · 适用人群：AI Agent / MCP 开发者 · 阅读时间：约 6 分钟
## 核心要点
- 官方提供接口级 MCP 服务，覆盖 104-41 排行榜与 104-42 单城查询全部接入点。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端中粘贴配置，把 `{your_appKey}` 换成真实 AppKey 即可对话式查空气。
- 适合做「AI 助手查天气/空气」「自然语言问某城空气」等 Agent 场景，无需写代码。
## Why：为什么用 MCP
过去要在 AI 对话里查空气，得自己写调用层；现在有了 MCP，客户端原生支持「即配即用」。你只需说「北京现在空气质量怎么样」，Agent 通过 MCP 调用接口、拿到 `quality`/`aqi`/`pm2_5` 并自然回答，零代码接入。
## What：MCP 配置
| 项 | 内容 |
|----|------|
| 服务地址 | `http://www.showapi.com.cn/mcp/104/{your_appKey}` |
| 覆盖接入点 | 104-41 排行榜、104-42 单城查询 |
| 客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
> 注意域名是 `showapi.com.cn`（非 `showapi.com`），配置时原样保留。
## How：在客户端中接入
将下方 JSON 加入客户端的 MCP 配置（把 `{your_appKey}` 替换为你的真实 AppKey，可在 https://www.showapi.com/console#/myApp 获取）：
```json
{
"mcpServers": {
"showapi-mcp-104": {
"url": "http://www.showapi.com.cn/mcp/104/{your_appKey}"
}
}
}
```
配置完成后，在对话中直接提问即可，例如：
- 「查一下北京现在的空气质量，AQI 和 PM2.5 分别是多少？」
- 「全国空气质量排行前 10 的城市有哪些？」
Agent 会通过 MCP 调用 104-42 / 104-41，返回 `quality`、`aqi`、`pm2_5`、`primary_pollutant` 等字段并用自然语言转述。
## 返回示例与解析
单城查询「北京」经 MCP 返回的结构与直连接口一致：`quality=优质`、`aqi=18`、`pm2_5=3`、`primary_pollutant` 为空（空气优时无首要污染物）。Agent 可据此回答「北京当前空气优质，AQI 18，PM2.5 仅 3，适宜户外活动」。
## 进阶 / 边界
- **AppKey 安全**：MCP 配置中的 AppKey 等同于密钥，请勿提交到公开仓库或分享给他人。
- **小地区回退**：问「某某镇」时会回退到上级城市，Agent 应在回答中说明实际参考城市。
- **等级文案**：线上返回「优质」等 6 类，回答文案与接口保持一致。
- **额度**：MCP 调用同样消耗免费额度，高频对话建议配合缓存或控制频率。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
MCP 让 AI 客户端原生调用，无需自己写请求代码；底层仍是 104 接口的同一套能力。
**Q2：配置后对话没反应？**
检查 AppKey 是否替换正确、网络是否可达该 MCP 地址、客户端是否已启用该 MCP Server。
**Q3：支持哪些接入点？**
接口级 MCP 覆盖 104-41 排行榜与 104-42 单城查询两个接入点。
**Q4：MCP 调用收费吗？**
接口本身免费（受免费档位限制），MCP 只是调用通道，同样计免费额度。
## 相关能力 / 下一步阅读
- [全国城市空气质量查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/air-quality-openapi-104)
- [全国城市空气质量查询：单城市实时查询集成指南（从请求到 UI 展示）](https://www.showapi.com/guides/air-quality-query-integration-104)
- **本系列共 11 篇**：查看[全国城市空气质量查询 · 指南总目录](https://www.showapi.com/guides/air-quality-guides-104)
