通过 MCP 协议在 AI 客户端(Cherry Studio/ChatBox)直接查邮编
邮编查询邮编区域互查ShowAPI免费接口API教程 # 通过 MCP 协议在 AI 客户端(Cherry Studio/ChatBox)直接查邮编
> 邮编区域互查(apiCode=1917)· 免费接口 · MCP 集成 · 初级~中级开发者 · 约 7 分钟
## 核心要点
- 邮编区域互查官方提供 **MCP 服务**,覆盖全部三个接入点,可在支持 MCP 的 AI 客户端里直接调用。
- MCP 配置只需一个 URL:`http://www.showapi.com.cn/mcp/1917/{your_appKey}`,把 `{your_appKey}` 换成真实 AppKey。
- 配置后,AI 客户端就能用自然语言帮你查邮编/地区,无需自己写 HTTP 代码。
## Why:让 AI 替你查邮编
如果你在用 Cherry Studio、ChatBox 这类支持 MCP 的 AI 客户端,接上这个 MCP 服务后,直接说「帮我查 362504 是哪个地方」,AI 就会调用接口并返回结果——适合非工程同学或快速验证。
## What:接口速览
| 项 | 说明 |
|----|------|
| 接口 | 邮编区域互查(apiCode=1917) |
| 集成方式 | MCP 服务(覆盖全部接入点) |
| MCP 地址 | `http://www.showapi.com.cn/mcp/1917/{your_appKey}` |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
## How:配置 MCP
在 AI 客户端的 MCP 配置中加入以下内容(把 `YOUR_APPKEY` 替换为你的真实 AppKey):
```json
{
"mcpServers": {
"showapi-mcp-1917": {
"url": "http://www.showapi.com.cn/mcp/1917/YOUR_APPKEY"
}
}
}
```
保存后在客户端启用该 MCP 服务,即可通过对话调用邮编区域互查的三个接入点。
## 返回示例与解析
MCP 调用本质仍是访问 `route.showapi.com/1917-*` 接口,返回结构与本文其他篇章一致(如 `contentlist` 含省/市/区/街道/邮编/区号)。差异仅在调用入口从「手写 HTTP」变成「AI 客户端自然语言触发」。
## 进阶/边界
- **AppKey 安全**:MCP 配置里直接写 AppKey,仅在可信的本地客户端使用,勿泄露。
- **覆盖范围**:该 MCP 服务覆盖全部三个接入点,无需为每个接入点单独配置。
- **字段差异仍适用**:接入点2 返回 `postcode`、免费档位接入点3 可能空列表等,与直接调用一致。
- **网络要求**:客户端需能访问 `showapi.com.cn` 的 MCP 端点。
## FAQ
**Q1:哪些客户端支持?**
支持 MCP 的客户端均可,如 Cherry Studio、ChatBox。
**Q2:MCP 地址里的 AppKey 怎么填?**
替换 `{your_appKey}` 为你在「我的 AppKey」拿到的真实值。
**Q3:配置后怎么用?**
在客户端对话框直接说查邮编/地区的需求,AI 会自动调用。
**Q4:能覆盖三个接入点吗?**
能,官方 MCP 服务覆盖全部接入点。
**Q5:和直接写代码调用有区别吗?**
返回数据一致,只是调用入口不同(自然语言 vs HTTP)。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger UI:用 OpenAPI 文档管理邮编区域互查接口](https://www.showapi.com/guides/postcode-openapi-1917)
- [邮编区域互查:5 分钟接入](https://www.showapi.com/guides/postcode-quickstart-1917)
- [邮编区域互查返回字段全解](https://www.showapi.com/guides/postcode-response-fields-1917)
- **本系列共 12 篇**:查看[邮编区域互查指南总目录](https://www.showapi.com/guides/postcode-guides-1917)