通过 MCP 在 AI 客户端直接查询 IP 归属地
# 通过 MCP 在 AI 客户端直接查询 IP 归属地
> 元信息：接口 全球IP地址查询（apiCode=20）· MCP 集成 · 免费 · 适用人群 AI 开发者/低代码 · 阅读时间 5 分钟
## TL;DR 快速概览
- ShowAPI 为该接口提供 **MCP 服务** `showapi-mcp-20`，覆盖全部接入点（20/1、20/2）。
- 在 Cherry Studio、ChatBox 等支持 MCP 的 AI 客户端里贴上配置，把 `{your_appKey}` 换成真实 key，即可让 AI 直接"查这个 IP 是哪的"。
- MCP 配置是接口级，一次接入两个接入点都能用。
## Why：让 AI 直接查归属地
LLM 本身不知道一个 IP 属于哪里。通过 MCP 把全球IP地址查询接进 AI 客户端后，你可以直接用自然语言问"203.0.113.220 是国内哪个城市、什么运营商"，AI 会调用工具拿到结构化归属地再回答——无需写代码、无需切网页。
## What：MCP 配置事实
| 项 | 内容 |
|----|------|
| MCP 服务名 | `showapi-mcp-20` |
| 覆盖范围 | 本接口全部接入点（20/1 IP查询、20/2 域名查询） |
| 配置地址 | `http://www.showapi.com.cn/mcp/20/{your_appKey}` |
| 获取 AppKey | [AppKey 管理](https://www.showapi.com/console#/myApp) |
> 文档未声明该 MCP 的鉴权/传输细节（如是否需 Bearer），按官方给出的 JSON 原样配置、替换 `{your_appKey}` 即可。
## How：在 AI 客户端配置
复制以下 JSON 到客户端的 MCP 配置处（Cherry Studio / ChatBox 等支持 MCP 的客户端）：
```json
{
"mcpServers": {
"showapi-mcp-20": {
"url": "http://www.showapi.com.cn/mcp/20/{your_appKey}"
}
}
}
```
把 `{your_appKey}` 替换为你在 [ShowAPI 控制台](https://www.showapi.com/console#/myApp) 拿到的真实 AppKey，保存并重启/刷新客户端，即可在对话中让 AI 调用"全球IP地址查询"。
## 返回示例与解析
配置生效后，对 AI 说"查一下 203.0.113.220 的归属地"，底层等价于请求 `20-1` 接入点，返回结构同 [返回字段全解](https://www.showapi.com/guides/ip-geo-response-fields-20)（country/region/city/isp/lnt/lat 等）。AI 会把工具返回整理成自然语言回答。
## 进阶 / 边界
- **两个接入点都可用**：MCP 覆盖全部接入点，既能查 IP（20/1）也能查域名（20/2），无需分别配置。
- **免费接口**：该 MCP 背后的接口免费，但受使用档位限制（见[免费档位指南](https://www.showapi.com/guides/ip-geo-free-tier-20)），高频 AI 调用同样注意缓存。
- **坐标系未声明**：如需在 AI 生成的地图/图表里用 `lnt`/`lat`，注意文档未声明坐标系，坐标为近似位置。
## FAQ
**Q1：哪些客户端支持？**
A：文档举例 Cherry Studio、ChatBox 等支持 MCP 的客户端；凡支持标准 MCP 接入的客户端均可按上述 JSON 配置。
**Q2：一个 MCP 能查域名吗？**
A：能。`showapi-mcp-20` 覆盖全部接入点，包含 20/2 域名查询。
**Q3：AppKey 填在哪？**
A：填在配置 URL 的 `{your_appKey}` 占位处（[控制台获取](https://www.showapi.com/console#/myApp)），不要外泄。
**Q4：配置后 AI 说调不通怎么办？**
A：先确认 AppKey 有效且未超档位；再确认客户端支持该 MCP 传输方式。具体传输/鉴权细节以官方 MCP 配置页为准。
## 相关能力 / 下一步阅读
- [导入 OpenAPI 文档管理全球IP地址查询接口](https://www.showapi.com/guides/ip-geo-openapi-20) — 另一种集成方式
- [5 分钟接入全球IP地址查询](https://www.showapi.com/guides/ip-geo-quickstart-20) — 代码直连
- [全球IP地址查询：返回字段全解](https://www.showapi.com/guides/ip-geo-response-fields-20) — 返回结构
- **本系列共 10 篇**：查看[全球IP地址查询指南总目录](https://www.showapi.com/guides/ip-geo-guides-20)
