通过 MCP 在 Cherry Studio / ChatBox 中直接调用歇后语查询
歇后语查询MCPCherryStudioChatBox # 通过 MCP 在 Cherry Studio / ChatBox 中直接调用歇后语查询
- **接口/接入点**:歇后语查询 · 1635-1(MCP 覆盖全部接入点)
- **是否免费**:是
- **请求方式**:MCP(HTTP)
- **返回格式**:JSON
- **适用人群**:AI 客户端用户、MCP/AI Agent 开发者
- **阅读时间**:约 6 分钟
## 核心要点
- 歇后语查询提供官方 MCP 服务,**无需写代码**即可在 Cherry Studio、ChatBox 等支持 MCP 的客户端里直接调用。
- MCP 地址:`http://www.showapi.com.cn/mcp/1635/{your_appKey}`,把 `{your_appKey}` 换成真实 AppKey。
- 蹭 AI Agent 热点:让对话机器人随时"来一句歇后语"。
## Why:为什么要走 MCP
不想写 HTTP 请求、不想管 AppKey 暴露?MCP 让你在 AI 客户端里把"歇后语查询"当一个工具直接挂上,对话中就能调用。适合做 AI 陪聊、国学小老师、互动出题。
## What:MCP 配置速览
| 项 | 值 |
|----|----|
| 服务地址 | `http://www.showapi.com.cn/mcp/1635/{your_appKey}` |
| 覆盖接入点 | 全部(本接口仅 1635-1) |
| 客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 鉴权 | AppKey 拼在 URL 路径中 |
## How:在客户端里配置
### 步骤 1 — 复制官方 MCP JSON
```json
{
"mcpServers": {
"showapi-mcp-1635": {
"url": "http://www.showapi.com.cn/mcp/1635/{your_appKey}"
}
}
}
```
### 步骤 2 — 填入真实 AppKey
把 `{your_appKey}` 替换为你的 AppKey([控制台获取](https://www.showapi.com/console#/myApp))。
### 步骤 3 — 在 Cherry Studio / ChatBox 中添加
1. 打开客户端的 MCP / 工具设置;
2. 粘贴上面的 JSON(已替换 AppKey);
3. 保存并启用 `showapi-mcp-1635`;
4. 在对话里说"来一句歇后语",客户端会调用该工具返回 `question`+`answer`。
## 返回示例与解析
MCP 返回的业务数据与其他调用方式一致,核心是 `contentlist` 数组:
```json
{ "showapi_res_body": {
"ret_code": "0",
"contentlist": [ { "question": "刘备摔阿斗", "answer": "收买人心" } ] } }
```
## 进阶 / 边界
- **AppKey 安全**:MCP URL 含 AppKey,仅在自己可信的客户端配置,不要外发配置文件。
- **免费限频**:MCP 调用同样计入免费档位,高频对话注意控制;具体档位以官方说明为准。
- **参数**:MCP 工具同样只暴露 `num`(随机条数),无分类参数。
## FAQ
**Q:哪些客户端支持?**
A:文档示例提及 Cherry Studio、ChatBox 等支持 MCP 的客户端;以各客户端实际支持为准。
**Q:MCP 和直接 HTTP 调用有区别吗?**
A:返回数据一致,区别在接入方式——MCP 让 AI 客户端把接口当工具直接挂上,无需手写请求。
**Q:AppKey 写在 URL 安全吗?**
A:仅在自己可信的客户端配置可用;不要分享含 AppKey 的配置文件。
**Q:能指定分类吗?**
A:不能,MCP 工具同样只暴露 `num`,无分类入参(见分类 workaround 篇)。
**Q:免费档位够 AI 对话用吗?**
A:闲聊级调用量通常够;高频需控频,具体以官方档位说明为准。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger UI:用 OpenAPI 文档管理歇后语查询接口](https://www.showapi.com/guides/xiehouyu-openapi-import-1635)
- [歇后语查询:5 分钟从注册到第一条结果](https://www.showapi.com/guides/xiehouyu-quickstart-1635)
- **本系列共 13 篇**:查看[歇后语查询指南总目录](https://www.showapi.com/guides/xiehouyu-guides-1635)