通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）中调用古籍查询 API
# 通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）中调用古籍查询 API
> 接口：古籍查询（apiCode 1643）· **免费服务** · 官方提供 MCP 服务，覆盖全部接入点
> 适用人群：用 AI 客户端做对话式古籍查询的开发者 / 爱好者 · 阅读时间：约 4 分钟
## 核心要点
- 古籍查询官方提供 MCP 服务，地址为 `http://www.showapi.com.cn/mcp/1643/{your_appKey}`，覆盖「查询古籍名称」与「查询古籍明细」两个接入点。
- 在支持 MCP 的 AI 客户端（如 Cherry Studio、ChatBox）里粘贴一段配置，即可用自然语言对话查古籍，无需自己写 HTTP 请求。
- 配置时把 `{your_appKey}` 替换成你在 ShowAPI 控制台拿到的真实 AppKey。
## Why：为什么用 MCP？
MCP 让大模型直接"长"出调用古籍查询的能力——你不用写代码，只要说"查一下《论语》学而篇的原文和译文"，客户端就会自动调接口并返回结果。适合做国学助手、读书陪练、内容创作辅助。
## What：MCP 配置速览
| 项目 | 说明 |
|------|------|
| 服务地址 | `http://www.showapi.com.cn/mcp/1643/{your_appKey}` |
| 覆盖接入点 | 1643-2（查询古籍名称）、1643-3（查询古籍明细） |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | 地址里的 AppKey 即鉴权，无需额外配置 |
## How：三步接入
**步骤 1 — 拿到 AppKey**
到 [AppKey 管理页](https://www.showapi.com/console#/myApp) 复制你的 AppKey。
**步骤 2 — 在客户端添加 MCP 配置**
在 Cherry Studio / ChatBox 的 MCP 设置里，新增一个服务器，填入以下 JSON（把 `YOUR_APPKEY` 换成真实值）：
```json
{
"mcpServers": {
"showapi-mcp-1643": {
"url": "http://www.showapi.com.cn/mcp/1643/YOUR_APPKEY"
}
}
}
```
**步骤 3 — 对话式查询**
配置保存并连接成功后，在对话框里直接提问，例如：
- "查一下《论语》的 titleId，再给我学而篇的原文和译文。"
- "《山海经》里有哪些内容？先列出目录再取第一篇。"
客户端会把你的自然语言转成对 1643-2 / 1643-3 的调用，并把返回的原文、译文整理给你。
## 返回示例（MCP 整理后的对话效果）
> 你：给我《论语》学而篇第一句原文和译文。
> 助手：（调用 1643-2 取 titleId → 调用 1643-3 取明细）
> 原文：子曰："学而时习之，不亦说乎？有朋自远方来，不亦乐乎？人不知而不愠，不亦君子乎？"
> 译文：孔子说："学了又时常温习和练习，不是很愉快吗？……"
## 进阶 / 边界
- **AppKey 安全**：MCP 配置里直接写了 AppKey，注意只在自己信任的客户端、本地环境使用，不要公开分享配置文件。
- **覆盖全部接入点**：该 MCP 同时支持"查目录"和"查明细"，无需为每个接入点单独配置。
- **失败排查**：若对话拿不到数据，先确认 AppKey 有效、接口已开通（免费接口默认可用），再看客户端 MCP 连接日志。
- **字段名仍是 trainslation**：即便通过 MCP 返回，译文的键名依旧是 `trainslation`（少一个 s），如需自行解析请留意。详见[返回字段全解](https://www.showapi.com/guides/ancient-books-fields-1643)。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
A：能力一样（都走 1643 接口），区别是 MCP 让 AI 客户端替你拼请求、解析返回，你用自然语言即可。
**Q2：除了 Cherry Studio / ChatBox，还能接别的吗？**
A：任何支持标准 MCP（HTTP/SSE 形式）的客户端都能用同一段配置接入。
**Q3：AppKey 泄露了怎么办？**
A：到 AppKey 管理页重置即可；MCP 配置里的旧 Key 同步更新。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理古籍查询接口](https://www.showapi.com/guides/ancient-books-openapi-1643)
- [古籍查询 API 返回字段全解：trainslation 拼写坑与每个字段含义](https://www.showapi.com/guides/ancient-books-fields-1643)
- [古籍查询 API：两个接入点怎么选？（名称目录 vs 明细）](https://www.showapi.com/guides/ancient-books-points-1643)
- **本系列共 10 篇**：查看[古籍查询 API 指南总目录](https://www.showapi.com/guides/ancient-books-guides-1643)
