通过 MCP 在 Cherry Studio / ChatBox 中直接调用免费经典语句 API
免费经典语句APIMCPCherryStudioChatBox # 通过 MCP 在 Cherry Studio / ChatBox 中直接调用免费经典语句 API
> 元信息:接口 1646-2 · 免费 · MCP 集成 · 返回 JSON · 适用人群 AI 客户端用户/AI Agent 开发者 · 阅读时间 5 分钟
## 核心要点
- 免费经典语句 API 提供官方 MCP 服务(接口级),url 为 `http://www.showapi.com.cn/mcp/1646/{your_appKey}`。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端里配置后,AI 可直接"取一句名言"而无需写代码。
- 配置时把 `{your_appKey}` 替换为真实 AppKey([控制台](https://www.showapi.com/console#/myApp) 获取)。
## Why:为什么用 MCP 而不是直接调 API
写代码调用适合工程集成;但如果你只是想在 AI 对话里顺手要一句名言、或让 Agent 自动给文案配金句,MCP 把接口变成"AI 能直接用的工具",零代码、即配即用,蹭上 AI Agent 的工作流。
## What:MCP 配置速览
| 项 | 值 |
|----|----|
| 服务名 | showapi-mcp-1646 |
| 协议地址 | `http://www.showapi.com.cn/mcp/1646/{your_appKey}` |
| 覆盖接入点 | 本接口全部接入点(1646-2) |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
> 注意:官方给出的 MCP 地址为 **http**(非 https),这是真实写法,照抄即可,不要擅自改为 https。
## How:在 AI 客户端中配置
**步骤 1 — 准备 AppKey**
到 [AppKey 管理](https://www.showapi.com/console#/myApp) 复制你的 AppKey。
**步骤 2 — 写入 MCP 配置(JSON)**
```json
{
"mcpServers": {
"showapi-mcp-1646": {
"url": "http://www.showapi.com.cn/mcp/1646/{your_appKey}"
}
}
}
```
将 `{your_appKey}` 替换为真实 AppKey 后,粘贴到客户端的 MCP 配置处(Cherry Studio / ChatBox 各有"添加 MCP Server"入口,按客户端指引填入)。
**步骤 3 — 对话中直接使用**
配置成功后,在对话里让 AI「取一句关于学习的经典语句」,AI 会通过 MCP 调用接口并返回 `body/author/name`。
## 返回示例与解析
MCP 返回的仍是接口原生结构:
```json
{
"showapi_res_body": {
"body": "书山有路勤为径,学海无涯苦作舟。",
"author": "韩愈",
"ret_code": 0,
"name": "古今贤文"
}
}
```
字段含义见 [返回字段全解](https://www.showapi.com/guides/classic-quotes-fields-1646)。
## 进阶 / 边界
- **`tag` 支持**:MCP 工具若暴露 `tag` 参数,可按主题取句;具体参数以客户端中工具定义为准。
- **鉴权安全**:AppKey 写在客户端配置中,注意客户端本地安全,不要共享含 AppKey 的配置给不可信方。
- **网络**:MCP 地址为 http,确保客户端所在网络可访问 `www.showapi.com.cn`。
## FAQ
**Q:MCP 地址为什么是 http 不是 https?**
这是官方文档给出的真实地址,照抄即可;不要自行改成 https,以免连接失败。
**Q:Cherry Studio 和 ChatBox 配置位置一样吗?**
都在"MCP Server / 工具"设置里添加,入口名称可能不同,但都接受上面的 JSON 结构。
**Q:配好后在哪看到这个工具?**
在客户端的工具/MCP 列表里会出现 `showapi-mcp-1646`,对话中 AI 可调用。
**Q:tag 参数在 MCP 里怎么传?**
取决于客户端对工具参数的暴露;若工具支持 `tag`,在对话或参数中指定(如「学习」),以实际工具定义为准。
**Q:AppKey 泄露风险?**
MCP 配置含 AppKey,仅存于你信任的客户端;如怀疑泄露,到控制台重置 AppKey。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger:用 OpenAPI 3.0 文档管理经典语句 API](https://www.showapi.com/guides/classic-quotes-openapi-import-1646) — 另一集成方式
- [5 分钟接入免费经典语句 API](https://www.showapi.com/guides/classic-quotes-quickstart-1646) — 代码方式调用
- [免费经典语句 API 标签筛选](https://www.showapi.com/guides/classic-quotes-tag-filter-1646) — tag 用法
- **本系列共 11 篇**:查看[免费经典语句 API 开发指南总目录](https://www.showapi.com/guides/classic-quotes-guides-1646)