通过 MCP 在 AI 客户端里直接调用童话故事集 API（Cherry Studio / ChatBox）
MCPCherryStudioChatBoxAI客户端 # 通过 MCP 在 AI 客户端里直接调用童话故事集 API（Cherry Studio / ChatBox）
> 元信息：童话故事集 API（apiCode=1700）· 集成能力 MCP · 免费服务 · 适用人群：AI Agent / MCP 开发者 · 阅读时间约 6 分钟
## 核心要点
- 童话故事集 API 提供接口级 MCP 服务，覆盖全部 3 个接入点，配置一段 JSON 即可在 AI 客户端中直接调用。
- MCP 地址：`http://www.showapi.com.cn/mcp/1700/{your_appKey}`，把 `{your_appKey}` 换成真实 AppKey。
- 配置后，可在 Cherry Studio、ChatBox 等支持 MCP 的客户端里用自然语言让孩子挑故事、听故事。
## Why：让 AI 直接"会讲"童话故事
如果你在做儿童向 AI 助手，最自然的体验是：孩子说"讲个安徒生童话"，AI 直接去接口取内容讲出来，而不用你事先把故事库搬进提示词。MCP（模型上下文协议）正好干这个——把童话故事集 API 暴露成 AI 可调用的工具。本篇讲清配置与用法。
## What：MCP 速览
| 项目 | 说明 |
|------|------|
| 协议 | MCP（Model Context Protocol） |
| 覆盖范围 | 接口 1700 全部接入点（分类/列表/详情） |
| 接入地址 | `http://www.showapi.com.cn/mcp/1700/{your_appKey}` |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | URL 中携带 AppKey |
## How：在 AI 客户端里配置
复制下面这段配置，把 `{your_appKey}` 替换为你在 https://www.showapi.com/console#/myApp 拿到的真实 AppKey：
```json
{
"mcpServers": {
"showapi-mcp-1700": {
"url": "http://www.showapi.com.cn/mcp/1700/{your_appKey}"
}
}
}
```
在 Cherry Studio / ChatBox 的 MCP 设置里粘贴上述 JSON 并保存，客户端会加载出 `showapi-mcp-1700` 这个服务及其下的工具（对应三个接入点）。启用后即可在对话中自然语言调用，例如：
- "列出童话故事集有哪些分类"
- "在安徒生童话分类里搜一个关于勇气的故事"
- "把这篇故事的完整内容讲给我听"
客户端会把你的话映射到对应的接入点参数（如 `classifyId`、`keyword`、`id`）并完成调用。
## 返回示例与解析
通过 MCP 调用后，AI 客户端拿到的仍是标准 JSON（与直接 HTTP 调用一致）：
```json
{
"showapi_res_body": {
"ret_code": "0",
"remark": "查询成功！",
"storylist": [
{ "classify": "儿童小故事", "classifyId": "1" },
{ "classify": "安徒生童话", "classifyId": "2" }
]
}
}
```
具体字段含义见[返回字段全解](https://www.showapi.com/guides/child-story-fields-1700)。
## 进阶 / 边界
- **AppKey 安全**：MCP 配置里直接写了 AppKey，仅用于你本机/受信客户端的个人使用；不要把它提交到公开仓库或分享给他人。
- **覆盖范围有限**：MCP 服务覆盖本接口三个接入点，不含其他接口；需要跨接口编排时在客户端侧自行组合。
- **无订阅/批量**：该接口本身无订阅推送或批量接入点，MCP 调用也是同步查询。
## FAQ
**Q: 哪些客户端支持这个 MCP？**
A: 文档示例提到 Cherry Studio、ChatBox 等支持 MCP 的客户端；以各客户端实际版本为准。
**Q: MCP 调用和直接 HTTP 调用结果一样吗？**
A: 一致，都返回标准 JSON；MCP 只是把接口封装成 AI 可调用工具，省去你手写 HTTP 代码。
**Q: AppKey 写在配置里安全吗？**
A: 仅限本机/受信客户端个人使用。避免公开分享含 AppKey 的配置；如需团队共享，走各自账号的 AppKey。
**Q: 能不能让 AI 自动按年龄推荐故事？**
A: 可以。分类本身无年龄字段，需你在提示词里定义"某分类≈某年龄段"，由 AI 按映射自行选择分类（参考[适龄推荐实践](https://www.showapi.com/guides/child-story-age-guide-1700)）。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理童话故事集 API](https://www.showapi.com/guides/child-story-openapi-1700)
- [童话故事集 API 返回字段全解](https://www.showapi.com/guides/child-story-fields-1700)
- [童话故事集 API：故事分类接入点怎么用](https://www.showapi.com/guides/child-story-classify-guide-1700)
- **本系列共 12 篇**：查看[童话故事集 API 指南总目录](https://www.showapi.com/guides/child-story-guides-1700)
