在 AI 客户端里直接调用周公解梦 API:MCP 配置教程
周公解梦MCPCherryStudioChatBoxAI客户端 # 在 AI 客户端里直接调用周公解梦 API:MCP 配置教程
> 接口:免费解梦详细(apiCode 1601)· 接入点:解梦详细(1601-2)· **免费** · 集成方式:MCP 服务(接口级,覆盖全部接入点)· 适用人群:AI 客户端 / Agent 开发者 · 阅读约 5 分钟
## 核心要点
- ShowAPI 提供接口级 MCP 服务,把 AppKey 填进配置即可让支持 MCP 的 AI 客户端直接「解梦」。
- 配置 JSON 中的服务名为 `showapi-mcp-1601`,地址为 `http://www.showapi.com.cn/mcp/1601/{your_appKey}`。
- 在 Cherry Studio、ChatBox 等客户端粘贴配置、替换 AppKey 即可,无需写代码。
## Why:这跟我有什么关系
你现在用 AI 助手(Cherry Studio / ChatBox 等),想让它「用户说梦见什么,它就调接口返回解读」。MCP 正是干这个的——你不用写后端,配一段 JSON,AI 客户端自己会去调周公解梦 API。
## What:前置条件与接口速览
| 项目 | 说明 |
|------|------|
| 集成能力 | MCP 服务(接口级,覆盖本接口全部接入点) |
| 服务名 | `showapi-mcp-1601` |
| MCP 地址 | `http://www.showapi.com.cn/mcp/1601/{your_appKey}`(`{your_appKey}` 换成真实 AppKey) |
| 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
| 接入点说明 | 内容参考《周公解梦全书》部分信息,提供解读参考(文化参考,非科学/医疗结论) |
## How:三步接上 MCP
**步骤 1 — 拿 AppKey**:在[AppKey 管理](https://www.showapi.com/console#/myApp)复制你的 AppKey。
**步骤 2 — 配置 MCP(把 `{your_appKey}` 换成真实值)**
```json
{
"mcpServers": {
"showapi-mcp-1601": {
"url": "http://www.showapi.com.cn/mcp/1601/{your_appKey}"
}
}
}
```
**步骤 3 — 在客户端启用**:以 Cherry Studio 为例,把上面的 JSON 粘贴到 MCP 配置处保存,重启/刷新后,对话里直接说「帮我解梦:梦见被追杀」,客户端会通过 MCP 调用接口并返回 `contentlist` 的解读。
> 不同客户端配置入口略有差异,但都是「粘贴这段 JSON + 替换 AppKey」。
## 返回示例与解析
MCP 调用底层仍是 `route.showapi.com/1601-2`,返回结构与文档完全一致:`showapi_res_body.contentlist` 为数组,每项含 `name` 与 `detailList`。客户端会把解读文本呈现给你。字段细节见《[返回字段全解](https://www.showapi.com/guides/dream-response-fields-1601)》。
## 进阶 / 边界
- **AppKey 安全**:MCP 配置里的 AppKey 相当于明文凭证,仅在你自己可信的客户端使用,不要提交到公开仓库。
- **内容为文化参考**:AI 返回的解读来自《周公解梦全书》类资料,应提示用户「仅供娱乐参考」,不要当作科学/医疗结论。
- **免费有档位限制**:AI 客户端高频调用也会吃免费档位,详见[免费档位说明](https://www.showapi.com/free-api)与《[免费档位与调用限制](https://www.showapi.com/guides/dream-free-tier-1601)》。
- **想自己写 Agent 调用?** 除 MCP 外,也可用 OpenAPI 文档让 Agent 直接消费,见《[导入 Postman / Swagger](https://www.showapi.com/guides/dream-openapi-import-1601)》。
## FAQ
**Q1:MCP 和直接调 API 有什么区别?**
MCP 让你不用写调用代码,AI 客户端按标准协议自动调用;直接调 API 则更灵活、可控,适合产品化后端。
**Q2:配置后 AI 还是查不到梦境?**
检查 AppKey 是否替换正确、MCP 服务是否启用、网络是否能访问 `showapi.com.cn`;接口失败时看返回的错误信息。
**Q3:AppKey 泄露了怎么办?**
立即在[AppKey 管理](https://www.showapi.com/console#/myApp)重置/停用该 AppKey。
**Q4:免费接口用 MCP 会收费吗?**
接口本身免费(有档位限制),MCP 只是调用通道,不产生额外费用。
**Q5:内容能当真吗?**
不能。属文化参考,提示用户「仅供娱乐参考」。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger:用 OpenAPI 文档管理你的周公解梦 API](https://www.showapi.com/guides/dream-openapi-import-1601)
- [周公解梦 API:5 分钟接入,从注册到查出第一个梦境解读](https://www.showapi.com/guides/dream-quickstart-1601)
- [周公解梦 API 返回字段全解:ret_code、contentlist、分页字段一文读懂](https://www.showapi.com/guides/dream-response-fields-1601)
- **本系列共 8 篇**:查看[周公解梦 API 指南总目录](https://www.showapi.com/guides/dream-guides-1601)