字典查询：通过 MCP 在 AI 客户端直接查字典（Cherry Studio / ChatBox 配置教程）
# 字典查询：通过 MCP 在 AI 客户端直接查字典（Cherry Studio / ChatBox 配置教程）
> 元信息：接口 **字典查询**（apiCode 1524）· 免费服务 · 提供 MCP 服务 · 适用：AI 客户端/MCP 开发者、想用自然语言查字典的用户 · 阅读时间约 6 分钟
## 核心要点
- 字典查询提供接口级 MCP 服务，覆盖全部 6 个接入点，配置后可在 Cherry Studio、ChatBox 等支持 MCP 的客户端直接调用。
- MCP 地址：`http://www.showapi.com.cn/mcp/1524/{your_appKey}`，把 `{your_appKey}` 替换为真实 AppKey。
- 配置后，用自然语言（如「查一下『你』字的部首和笔画」）即可查字典，无需写代码。
## Why：为什么用 MCP 而不是自己写调用
MCP（Model Context Protocol）让 AI 客户端直接拥有「查字典」能力。你不用在应用里手搓 HTTP 请求与解析 JSON，只要在客户端贴一段配置，AI 就能自己决定调哪个接入点、怎么组织答案。对做 AI 助手、语文学习 Agent 的团队尤其省力。
## What：前置条件与接口速览
| 项 | 值 |
|----|----|
| 接口 | 字典查询 1524（MCP 覆盖全部接入点） |
| MCP 地址 | `http://www.showapi.com.cn/mcp/1524/{your_appKey}` |
| 支持客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | AppKey 直接写在 URL 路径中 |
| 计费 | 免费（档位限额） |
AppKey 管理：[控制台](https://www.showapi.com/console#/myApp)
接口详情页：[https://www.showapi.com/apiGateway/view/1524](https://www.showapi.com/apiGateway/view/1524)
## How：在 AI 客户端配置 MCP
### 步骤 1：拿到 AppKey
登录 [ShowAPI 控制台](https://www.showapi.com/console#/myApp) 获取 AppKey。
### 步骤 2：在客户端添加 MCP 服务
以 Cherry Studio / ChatBox 为例，在 MCP 配置中新增一个服务，填入以下 JSON（把 `YOUR_APPKEY` 换成真实值）：
```json
{
"mcpServers": {
"showapi-mcp-1524": {
"url": "http://www.showapi.com.cn/mcp/1524/YOUR_APPKEY"
}
}
}
```
### 步骤 3：对话验证
配置保存后，在对话中直接用自然语言提问，例如：
- 「查一下『你』字的拼音、部首、笔画和五笔」
- 「拼音 a 下有哪些汉字？」
- 「『针砭时弊』是什么意思？」
AI 客户端会自动选择合适的接入点（1524-5 / 1524-3 / 1524-6 等）并返回结构化结果。
## 返回示例与字段解析
通过 MCP 返回的内容与直接调用接口一致：
- 单字详情（1524-5）：`hanzi` / `pinyin` / `bushou` / `bihua` / `wubi` / `words` / `basic_explain` / `detail_explain`。
- 词语/成语（1524-6）：`ciyu` / `pinyin` / `cidian_explain` / `allusion_explain`（可能为空）。
字段含义见[字典查询：返回字段全解](https://www.showapi.com/guides/dict-response-codes-1524)。
## 进阶 / 边界
- **AppKey 安全**：MCP 配置把 AppKey 写在 URL 中，仅在你自己信任的客户端使用，不要分享含 AppKey 的配置。
- **档位限额同样生效**：MCP 调用仍计入免费档位，高频场景参考[缓存与降级指南](https://www.showapi.com/guides/dict-cache-degrade-1524)。
- **自然语言不等于万能**：AI 的回答质量取决于它如何正确选择接入点与参数；复杂业务仍建议用 API 直连。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
MCP 让 AI 客户端自动调用，你用自然语言交互；直接调 API 需要自己写代码。前者适合人机对话，后者适合把数据嵌进你的系统。
**Q2：AppKey 写在 URL 里安全吗？**
仅在你自己控制的客户端配置中使用，不要外泄。如担心，可优先用 API 直连并在服务端保管 AppKey。
**Q3：哪些客户端支持？**
文档示例为 Cherry Studio、ChatBox 等支持 MCP 的客户端；只要支持标准 MCP 接入即可按相同 JSON 配置。
**Q4：MCP 调用也受免费档位限制吗？**
是的，MCP 本质还是调用同一接口，档位限额同样生效。
## 相关能力 / 下一步阅读
- [字典查询：导入 Postman / Swagger，用 OpenAPI 文档管理你的接口](https://www.showapi.com/guides/dict-openapi-1524)
- [字典查询：5 分钟接入，从注册到查出第一个汉字详情](https://www.showapi.com/guides/dict-quickstart-1524)
- [字典查询：语文学习 App 如何集成？](https://www.showapi.com/guides/dict-learning-app-1524)
- **本系列共 12 篇**：查看[字典查询指南总目录](https://www.showapi.com/guides/dict-guides-1524)
