唐诗宋词元曲查询：通过 MCP 协议在 Cherry Studio / ChatBox 中直接查诗词
唐诗宋词元曲查询MCPCherryStudioChatBoxAI客户端 # 唐诗宋词元曲查询：通过 MCP 协议在 Cherry Studio / ChatBox 中直接查诗词
> 接口：唐诗宋词元曲等诗词查询（apiCode=1620）· 免费 · 提供 MCP 服务（覆盖全部接入点）· 适用：AI Agent / MCP 开发者 · 阅读约 5 分钟
## 核心要点
- 接口官方提供 **MCP 服务**，覆盖全部 3 个接入点，配置一次即可在支持 MCP 的 AI 客户端里直接调用
- 配置只需一段 JSON，把 `{your_appKey}` 替换为你的真实 AppKey
- MCP 地址为 `http://www.showapi.com.cn/mcp/1620/{your_appKey}`（注意是 `.com.cn` 且 http 协议，以官方文档为准）
## Why：让 AI 助手替你查诗，不用写代码
如果你在做 AI 客户端（Cherry Studio、ChatBox 等）或 Agent，不想自己拼请求，可以直接把这套诗词接口「挂」成 MCP 工具。配置好后，你只要对 AI 说「查一下苏轼的《前赤壁赋》」，它就能调接口拿到原文译文注释，省去手写调用层。
## What：MCP 服务速览
| 项目 | 说明 |
|------|------|
| 接口编码 | 1620 |
| 集成方式 | MCP 协议（Model Context Protocol） |
| 覆盖范围 | 本接口全部接入点（1620-3 / 1620-4 / 1620-5） |
| 配置地址 | `http://www.showapi.com.cn/mcp/1620/{your_appKey}` |
| 鉴权 | AppKey 写入 URL 路径 |
| 计费 | 免费（有使用档次限制） |
## How：三步在 AI 客户端启用
### 步骤 1 · 准备 AppKey
在 [AppKey 管理页](https://www.showapi.com/console#/myApp) 拿到你的 `appKey`。
### 步骤 2 · 写入 MCP 配置
将下面 JSON 中的 `{your_appKey}` 替换为真实 AppKey，加入客户端的 MCP 配置：
```json
{
"mcpServers": {
"showapi-mcp-1620": {
"url": "http://www.showapi.com.cn/mcp/1620/{your_appKey}"
}
}
}
```
> 注意：官方文档给出的地址主机是 `www.showapi.com.cn`、协议为 `http`，请以此为准；若客户端要求 https，以官方最新文档说明为准。
### 步骤 3 · 在客户端对话中调用
配置保存并连接后，直接在对话里用自然语言请求，例如：
- 「列出所有朝代」
- 「查宋代诗人苏轼的生平」
- 「给我《前赤壁赋》的原文、译文和注释」
客户端会把请求路由到对应接入点并返回结果。
**命令行快速验证（curl 探活示意）**
```bash
curl -X POST "http://www.showapi.com.cn/mcp/1620/YOUR_APPKEY" \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```
> 上面是 MCP 通用握手示意；实际工具名与参数以服务端返回为准，可用 `tools/list` 查看可用工具。
## 返回示例与解析
MCP 返回会被客户端转成可读文本，其底层数据与直连接口一致，例如查朝代时仍是 `dynastyInfo` 数组（含 `dynasty` / `dynastyId`），查诗词时仍是 `poemInfo` / `contentlist`。
## 进阶 / 边界
- **覆盖全部接入点**：一次配置即可用三个能力（朝代/诗人/诗词），无需为每个接入点单独配。
- **AppKey 安全**：MCP 地址把 AppKey 放在 URL 路径里，请确保客户端配置仅存于你信任的环境，避免泄露。
- **限流仍适用**：经 MCP 调用同样计入免费档位，高频使用请参考缓存与限流篇的思路（在服务端侧做缓存）。
- **客户端差异**：不同 MCP 客户端对 `http` 地址、SSE/Streamable 传输的支持略有差异，连接异常时以客户端日志与官方文档为准。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
直连需要你自己写请求代码；MCP 把接口包装成 AI 客户端可识别的工具，你用自然语言即可调用，适合 Agent 场景。底层数据与直连一致。
**Q2：配置后连不上怎么办？**
先确认 AppKey 已正确替换、地址主机与协议（`www.showapi.com.cn` / `http`）与官方文档一致；检查客户端是否支持该传输方式。可用 `tools/list` 探活确认服务可达。
**Q3：MCP 调用也免费吗？有限流吗？**
是，MCP 走同一接口，免费但受使用档次限制，额度消耗与直连一致。
**Q4：能在多个客户端共用同一份配置吗？**
可以，配置里的 AppKey 与地址是通用的；但 AppKey 属敏感信息，建议仅存放在可信客户端、避免外泄。
## 相关能力 / 下一步阅读
- [唐诗宋词元曲查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/poem-openapi-import-1620) — 另一条生态路径：API 文档治理
- [唐诗宋词元曲查询：从「朝代」到「诗人」到「诗词」三步全链路串联](https://www.showapi.com/guides/poem-three-step-flow-1620) — 理解三个接入点的衔接关系
- **本系列共 12 篇**：查看[唐诗宋词元曲查询指南总目录](https://www.showapi.com/guides/poem-guides-1620)
