通过 MCP 协议在 AI 客户端中直接调用渣男语录
渣男语录MCPAI客户端Cherry StudioChatBox # 通过 MCP 协议在 AI 客户端中直接调用渣男语录
- **接口/接入点**：免费渣男语录（apiCode=2962，接入点 1） · **是否免费**：免费 · **请求方式**：POST/GET · **返回格式**：JSON · **适用人群**：AI Agent 开发者、使用 Cherry Studio / ChatBox 等客户端的用户 · **阅读时间**：约 5 分钟
## 核心要点
- 渣男语录提供**官方 MCP 服务**，覆盖本接口全部接入点，无需自己写 HTTP 封装。
- 在支持 MCP 的 AI 客户端（如 Cherry Studio、ChatBox）里配置一段 JSON 即可让 Agent 直接调用。
- MCP 地址域名是 `showapi.com.cn`（文档原文），配置时把 `{your_appKey}` 换成真实 AppKey。
## Why：这跟我有什么关系
- 想在本地 AI 助手里加一个"讲土味情话"的能力？通过 MCP，Agent 自己就能按需调用渣男语录，不用你手动拼请求。
- 蹭上 AI Agent / MCP 热度，把轻量娱乐接口变成 Agent 的"才艺技能"。
## What：MCP 配置速览
| 项 | 值 |
|----|----|
| 协议 | MCP（Model Context Protocol） |
| 覆盖接入点 | 本接口全部接入点（仅接入点 1） |
| MCP 地址 | `http://www.showapi.com.cn/mcp/2962/{your_appKey}` |
| 需要 | 支持 MCP 的客户端（Cherry Studio / ChatBox 等）+ 真实 AppKey |
> 注：MCP 地址使用 `showapi.com.cn` 域名（与官网 `showapi.com` 不同），这是接口文档给出的官方配置，照实填写即可。
## How：三步接入
### 步骤 1 · 准备 AppKey
在 [AppKey 管理](https://www.showapi.com/console#/myApp) 复制你的 AppKey。
### 步骤 2 · 写入 MCP 配置
在你所用客户端的 MCP 配置文件里加入（把 `{your_appKey}` 替换为真实值）：
```json
{
"mcpServers": {
"showapi-mcp-2962": {
"url": "http://www.showapi.com.cn/mcp/2962/{your_appKey}"
}
}
}
```
### 步骤 3 · 在对话中调用
配置保存并连接后，直接在客户端里让 Agent「来一句渣男语录」「讲个土味情话」，Agent 会通过 MCP 调用接口并返回 `text`。
## 返回示例与解析
MCP 调用最终等价于直接请求接口，业务返回仍是：
```json
{
"showapi_res_body": {
"ret_code": 0,
"text": "你不要闹了，她只是我的小学同学。",
"remark": ""
}
}
```
Agent 拿到的可用内容即 `text` 字段；若 `ret_code=-1` 表示接口准备中，可重试。
## 进阶 / 边界
- **仅覆盖本接口**：MCP 服务覆盖渣男语录全部接入点，不涉及 ShowAPI 其他接口；要调别的接口需各自配置。
- **域名差异**：MCP 用 `showapi.com.cn`，官网/OpenAPI 用 `showapi.com`，两者都是官方地址，无需纠结。
- **娱乐定位**：返回内容含戏谑/土味情话，仅作娱乐用途，详见 [《内容合规与娱乐边界》](https://www.showapi.com/guides/zhanan-quotes-content-compliance-2962)。
## FAQ
- **Q：MCP 和直接调 API 有什么区别？** A：MCP 让 AI 客户端/Agent 自动发现并调用工具，省去手写 HTTP 代码；结果一致。
- **Q：为什么 MCP 地址是 showapi.com.cn 而不是 showapi.com？** A：这是接口文档给出的官方 MCP 配置域名，照实填写即可。
- **Q：哪些客户端支持？** A：支持 MCP 协议的客户端均可，如 Cherry Studio、ChatBox 等。
- **Q：配置后调不通？** A：先确认 AppKey 已替换且有效，再检查客户端是否成功连接 MCP 服务；也可先用 [Quickstart](https://www.showapi.com/guides/zhanan-quotes-quickstart-2962) 的直接请求验证连通性。
- **Q：需要传业务参数吗？** A：不需要，本接口无业务必填参数，仅 appKey 鉴权。
## 相关能力 / 下一步阅读
- [渣男语录：5 分钟接入，从注册到第一条土味情话](https://www.showapi.com/guides/zhanan-quotes-quickstart-2962)
- [导入 Postman / Swagger：用 OpenAPI 文档管理渣男语录接口](https://www.showapi.com/guides/zhanan-quotes-openapi-import-2962)
- [聊天机器人如何接入渣男语录？从调用到展示的全链路设计](https://www.showapi.com/guides/zhanan-quotes-chatbot-integration-2962)
- **本系列共 7 篇**：查看[渣男语录指南总目录](https://www.showapi.com/guides/zhanan-quotes-guides-2962)
