天气预报国际版：通过 MCP 在 AI 客户端中直接查天气
天气预报国际版MCPAI客户端Cherry Studio # 天气预报国际版：通过 MCP 在 AI 客户端中直接查天气
> 接口：天气预报国际版（apiCode=3540）· 免费接口 · MCP 接入 · 适用人群：AI 应用开发者、效率工具用户 · 阅读时间：约 5 分钟
## 核心要点
- 天气预报国际版提供**接口级 MCP 服务**（`showapi-mcp-3540`），覆盖本接口全部 3 个接入点（当前天气 / 24 小时预报 / 14 天预报）。
- 配置只需一段 MCP JSON，把 `{your_appKey}` 换成你的真实 AppKey，粘贴到 Cherry Studio、ChatBox 等支持 MCP 的客户端即可。
- 配置完成后，用自然语言就能查全球天气："伦敦现在多少度？""东京未来 14 天会下雨吗？"——不用写一行代码。
## Why
想让 AI 助手回答天气问题，通常要自己写 function calling 的工具层：定义工具、解析参数、调接口、拼回结果。MCP（Model Context Protocol）把这件事标准化了——服务商直接提供现成的 MCP 服务端，客户端即插即用。
天气预报国际版的 MCP 服务覆盖接口全部接入点，意味着你接上一次，"当前天气、24 小时、14 天"三类问题都能在 AI 客户端里直接问。对不写代码的使用者，这是零成本用上全球天气数据的方式；对开发者，这是把天气能力快速塞进 AI 工作流的捷径。
## What
官方页面给出的 MCP 配置（MCP JSON）：
```json
{
"mcpServers": {
"showapi-mcp-3540": {
"url": "http://www.showapi.com.cn/mcp/3540/{your_appKey}"
}
}
}
```
| 项目 | 说明 |
|------|------|
| 服务名 | `showapi-mcp-3540` |
| URL 模式 | `http://www.showapi.com.cn/mcp/3540/{your_appKey}`（AppKey 直接拼在 URL 中） |
| 覆盖范围 | 本接口全部接入点（3540-1 / 3540-2 / 3540-3） |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 获取 AppKey | [AppKey 管理控制台](https://www.showapi.com/console#/myApp) |
## How
### 1. 拿到 AppKey
登录后在 [AppKey 管理控制台](https://www.showapi.com/console#/myApp)复制你的 AppKey（免费接口注册后默认可调用）。
### 2. 在 MCP 客户端中添加服务
以支持 MCP 的客户端为例（Cherry Studio / ChatBox 等入口名称略有差异，位置一般在"设置 → MCP / 工具服务"）：
1. 新建/添加一个 MCP 服务；
2. 类型选 URL（远程服务），粘贴配置：
```json
{
"mcpServers": {
"showapi-mcp-3540": {
"url": "http://www.showapi.com.cn/mcp/3540/把这里换成你的AppKey"
}
}
}
```
3. 保存并启用该服务。
### 3. 用自然语言验证
在客户端对话框里直接问：
```text
伦敦现在的天气怎么样？
东京未来 14 天哪几天降雨概率最低？
曼谷今天下午适合户外跑步吗？
```
AI 客户端会通过 MCP 调用对应接入点（当前天气 / 14 天预报等）并汇总回答。
### 4. 开发者补充：HTTP 直连（同样的数据面）
MCP 之外，程序化接入仍然走 HTTP 接口（本文系列其他篇目的主题）。两者共用同一个 AppKey 与计费档位：
```bash
curl -X POST "https://route.showapi.com/3540-1?appKey=YOUR_APPKEY&name=London"
```
## 返回示例与解析
MCP 模式下由客户端把工具返回组织成自然语言回答，无需你解析 JSON；底层拿到的仍是接口标准结构（实测 HTTP 侧）：
```json
{
"showapi_res_body": {
"ret_code": 0,
"cityInfo": { "city": "伦敦", "city_en": "London", "time_zone": "Europe/London" },
"now": { "temperature": 18.9, "weather": "阴天", "humidity": 83 }
}
}
```
字段含义见[返回字段全解](https://www.showapi.com/guides/global-weather-response-fields-3540)。
## 进阶与边界
- **MCP 客户端行为未在本文实测**：本文的 MCP 配置信息来自官方接口文档页面；各客户端的配置入口与表现以客户端实际版本为准。HTTP 接口本身已实测可用。
- **AppKey 出现在 URL 中**：注意不要把含真实 AppKey 的 MCP 配置截图/粘贴到公开场合；泄露后请在控制台处理。
- **与 HTTP 调用共享档位**：MCP 调用与程序化 HTTP 调用消耗同一 AppKey 的调用次数，高频使用同样建议关注[缓存策略](https://www.showapi.com/guides/global-weather-cache-cost-3540)思路（AI 场景下可让上层应用对同一城市短时间内复用答案）。
- **定位表达**：自然语言里说"北京"或"伦敦"即可；生僻地名建议说出英文或坐标，原因见[定位参数](https://www.showapi.com/guides/global-weather-location-params-3540)。
## FAQ
**Q1：MCP 服务需要额外付费吗？**
MCP 服务覆盖本接口全部接入点，接口本身为免费接口（防滥用档次限制，以官方档位说明为准），调用消耗同一 AppKey 的额度。
**Q2：哪些客户端能用？**
官方页面点名为 Cherry Studio、ChatBox 等支持 MCP 的客户端；任何支持远程 URL 型 MCP 服务的客户端理论上均可，以客户端实际支持为准。
**Q3：配置后客户端看不到工具怎么办？**
按顺序检查：① URL 中 `{your_appKey}` 是否已替换为真实 AppKey；② 服务是否已"启用"；③ 客户端是否支持远程 URL 型 MCP 服务。
**Q4：MCP 调用失败会扣次吗？**
HTTP 侧实测失败调用 `showapi_fee_num=0` 不扣次；MCP 模式底层为同一接口，计费口径一致（以官方计费说明为准）。
**Q5：一个 MCP 配置能覆盖 24 小时和 14 天预报吗？**
能。官方说明该 MCP 服务覆盖本接口全部接入点（3540-1/2/3）。
## 下一步阅读
- [天气预报国际版：导入 Postman / Swagger UI，用 OpenAPI 文档管理接口](https://www.showapi.com/guides/global-weather-openapi-postman-3540)
- [天气预报国际版：5 分钟快速开始（注册到第一次全球天气查询）](https://www.showapi.com/guides/global-weather-quickstart-3540)
- [天气预报国际版：14 天预报接入实战（行程规划与日出日落、月相字段）](https://www.showapi.com/guides/global-weather-14day-forecast-3540)
- **本系列共 12 篇**：查看[天气预报国际版指南总目录](https://www.showapi.com/guides/global-weather-guides-3540)
