通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）中直接查询历史上的今天
历史上的今天MCPAI客户端CherryStudio # 通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）中直接查询历史上的今天
> 接口：历史上的今天（apiCode=119，接入点 119-42）· 免费 · 集成能力：MCP 服务 · 适用人群：AI 客户端用户、Agent 开发者 · 阅读时间：约 5 分钟
## 核心要点
- 官方提供 MCP 配置，把"历史上的今天"变成 AI 客户端里可直接调用的工具。
- 配置里的 `{your_appKey}` 替换成你的真实 AppKey 即可。
- 适配 Cherry Studio、ChatBox 等支持 MCP 的客户端，覆盖本接口全部接入点。
## Why：让 AI 帮你"翻历史"
不想写代码？把接口挂成 MCP 工具，直接在 AI 对话框里问"今天历史上发生了什么""2 月 20 日有什么大事"，AI 客户端自动调用接口返回结果。适合做知识问答、日报素材、教育助手。
## What：MCP 配置事实（来自官方文档）
官方给出的 MCP JSON（注意文档原文为 `http` 与 `showapi.com.cn` 域名）：
```json
{
"mcpServers": {
"showapi-mcp-119": {
"url": "http://www.showapi.com.cn/mcp/119/{your_appKey}"
}
}
}
```
> 说明：以上 `url` 按官方文档原文保留（`http://` 协议、`showapi.com.cn` 域名）。若你实测需 `https` 或 `www.showapi.com` 域名，以官方最新文档/客户端实际连接结果为准，本文不擅自"修正"。
## How：在客户端里配置
以 Cherry Studio / ChatBox 类客户端为例：
1. 打开客户端的 **MCP 服务器** 设置页。
2. 新增一个 MCP 服务器，类型选 **HTTP / Streamable**（URL 型）。
3. 把上面的 `url` 中的 `{your_appKey}` 替换为你的真实 AppKey（在 https://www.showapi.com/console#/myApp 获取）。
4. 保存并启用，客户端会拉取工具列表，出现"历史上的今天"相关工具。
5. 在对话框直接问，例如："查询今天历史上的今天"或"2月20日有哪些历史事件"。
### 配置示例（填好后）
```json
{
"mcpServers": {
"showapi-mcp-119": {
"url": "http://www.showapi.com.cn/mcp/119/你的真实AppKey"
}
}
}
```
## 返回示例与解析
通过 MCP 调用后，客户端拿到的业务数据与直接 HTTP 调用一致：位于 `showapi_res_body.list`，含 `year/month/day/title`，`needContent=1` 时含 `content`/`img`。AI 会把它组织成自然语言回答。
## 进阶 / 边界
- **AppKey 保密**：MCP 配置里的 AppKey 等同于调用凭证，不要在公网仓库/公开配置里泄露。
- **覆盖全部接入点**：该 MCP 服务覆盖本接口全部接入点（本品仅 1 个：119-42）。
- **连接失败排查**：若客户端连不上，先确认 `url` 中 AppKey 已替换、网络可达；协议/域名以官方文档与客户端实测为准。
## FAQ
**Q1：支持哪些客户端？**
文档点名 Cherry Studio、ChatBox 等支持 MCP 的客户端；任何兼容 MCP 的客户端均可尝试。
**Q2：需要写代码吗？**
不需要。填好 MCP 配置即可在对话框直接使用。
**Q3：AppKey 写在配置里安全吗？**
AppKey 是调用凭证，仅放在你自己的客户端配置中，切勿提交到公开仓库。
**Q4：MCP 和直接调 API 返回一样吗？**
业务数据一致（都在 `showapi_res_body.list`），只是调用入口从 HTTP 变为 MCP 工具。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理历史上的今天接口](https://www.showapi.com/guides/history-today-openapi-119) — 另一种集成方式。
- [历史上的今天：5 分钟接入，从注册到第一条历史事件](https://www.showapi.com/guides/history-today-quickstart-119) — 直接 HTTP 调用。
- [历史上的今天返回字段全解：list / title / year / content / img 一文读懂](https://www.showapi.com/guides/history-today-response-fields-119) — 返回结构。
- **本系列共 10 篇**：查看[历史上的今天指南总目录](https://www.showapi.com/guides/history-today-guides-119)
