通过 MCP 在 AI 客户端直接调用行政区划查询
# 通过 MCP 在 AI 客户端直接调用行政区划查询
> 接口 / 接入点：行政区划查询（apiCode 1149）· 区域查询 1149-1 / 子区域查询 1149-2 · 免费服务
> 集成方式：MCP 协议 · 适用人群：AI 客户端用户、Agent 开发者 · 阅读时间：约 5 分钟
## 核心要点
- 行政区划查询官方提供 **MCP 服务**，覆盖全部接入点，无需自己写调用代码。
- 在支持 MCP 的客户端（如 Cherry Studio、ChatBox）配置一段 JSON 即可让 AI 直接查区划。
- 把 `{your_appKey}` 替换成你的真实 AppKey（[控制台获取](https://www.showapi.com/console#/myApp)）即可。
## Why：让 AI 直接查行政区划
当你在 AI 客户端里问「昆明市的区号是多少」「广东省下有哪些市」，如果客户端接了行政区划查询的 MCP，AI 就能实时调用接口拿到权威数据，而不是凭记忆编。对做地址助手、表单助手的 Agent 尤其有用。
## What：MCP 配置速览
- 服务名：`showapi-mcp-1149`
- 协议地址：`http://www.showapi.com.cn/mcp/1149/{your_appKey}`
- 覆盖范围：区域查询（1149-1）+ 子区域查询（1149-2）
- 前提：一个 ShowAPI AppKey
> 说明：官方提供的 MCP 地址使用 `http://www.showapi.com.cn` 域名。按各 AI 客户端对 MCP 传输的要求配置即可；如客户端要求 HTTPS，以官方最新文档 / 控制台说明为准。
## How：在 AI 客户端配置
复制下面的 JSON，把 `{your_appKey}` 换成你的真实 AppKey：
```json
{
"mcpServers": {
"showapi-mcp-1149": {
"url": "http://www.showapi.com.cn/mcp/1149/{your_appKey}"
}
}
}
```
以 Cherry Studio / ChatBox 为例：
1. 打开客户端的「MCP 服务 / 工具」配置页。
2. 新增一个 MCP Server，名称填 `showapi-mcp-1149`，类型选「URL / Streamable」。
3. 粘贴上面的 JSON（替换 AppKey）。
4. 保存并连接，确认工具列表中出现行政区划查询相关能力。
5. 在对话里直接问「查一下浙江省下有哪些地级市」，AI 会通过 MCP 调用接口返回结果。
## 调用验证（可选，直接用接口核对）
如果你想先确认接口本身正常，再接 MCP，可以用区域查询快速验证：
```bash
curl -X POST "https://route.showapi.com/1149-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "level=2&areaName=%E6%98%86%E6%98%8E%E5%B8%82&page=1"
```
## 返回示例（区域查询）
```json
{ "showapi_res_body": { "ret_code": 0, "data": [
{"areaName": "昆明市", "id": "530100000000", "areaCode": "0871", "zipCode": "650000", "wholeName": "中国,云南省,昆明市"}
] } }
```
## 进阶 / 边界
- MCP 覆盖全部接入点：省级到村委会的下钻都能通过 MCP 完成，无需分别配置。
- AppKey 安全：MCP 配置里的 AppKey 等同凭证，仅在可信的本地 / 私有客户端使用，不要提交到公开仓库。
- 若客户端提示连接失败，先确认 AppKey 有效、网络可达官方 MCP 地址。
## FAQ
**Q：哪些客户端支持这个 MCP？**
官方示例提到 Cherry Studio、ChatBox 等支持 MCP 的客户端；具体以各客户端版本为准。
**Q：MCP 地址用 http 还是 https？**
官方给出的地址为 `http://www.showapi.com.cn/mcp/1149/{your_appKey}`；若你的客户端要求 HTTPS，以官方最新文档 / 控制台说明为准。
**Q：接了 MCP 还要写代码吗？**
不需要。配置好 JSON 后，AI 客户端会自动发现并调用，你直接用自然语言提问即可。
**Q：AppKey 泄露了怎么办？**
MCP 配置中的 AppKey 等同凭证，避免在公开环境暴露；如泄露，到控制台重置 AppKey。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理行政区划查询接口](https://www.showapi.com/guides/region-query-openapi-1149)
- [行政区划查询：5 分钟接入，从注册到第一条区划数据](https://www.showapi.com/guides/region-query-quickstart-1149)
- **本系列共 11 篇**：查看[行政区划查询指南总目录](https://www.showapi.com/guides/region-query-guides-1149)
