通过 MCP 协议在 AI 客户端中直接调用紫微斗数排盘
# 通过 MCP 协议在 AI 客户端中直接调用紫微斗数排盘
> 接口/接入点：紫微斗数排盘（apiCode=1647，接入点 1） · 免费 · 支持 MCP 服务 · 适用人群：AI 客户端用户、Agent 开发者 · 阅读时间约 6 分钟
## 核心要点
- 易源为紫微斗数接口提供**接口级 MCP 服务**，覆盖全部接入点，MCP Server 名 `showapi-mcp-1647`。
- 在支持 MCP 的客户端（如 Cherry Studio、ChatBox）配置一段 JSON 即可让 AI 直接调用排盘。
- MCP 地址：`http://www.showapi.com.cn/mcp/1647/{your_appKey}`，把 `{your_appKey}` 换成真实 AppKey。
## Why：为什么用 MCP 调这个接口
MCP（Model Context Protocol）让 AI 客户端像调用本地工具一样调用远程 API。配好紫微斗数 MCP 后，你可以直接在对话里说「帮我排一下 1993-10-27 06 出生的男性命盘」，AI 自动调用接口、拿到命盘并解读，无需写代码。对做 AI 工具/Chatbot 的开发者尤其方便。
## What：MCP 配置速览
| 项目 | 内容 |
|------|------|
| MCP Server 名 | `showapi-mcp-1647` |
| MCP 地址 | `http://www.showapi.com.cn/mcp/1647/{your_appKey}` |
| 覆盖接入点 | 本接口全部接入点（排盘 1647-1） |
| 获取 AppKey | [AppKey 管理页](https://www.showapi.com/console#/myApp) |
| 支持客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 |
## How：在客户端配置 MCP
在客户端的 MCP 配置处加入以下 JSON（把 `YOUR_APPKEY` 替换为真实 AppKey）：
```json
{
"mcpServers": {
"showapi-mcp-1647": {
"url": "http://www.showapi.com.cn/mcp/1647/YOUR_APPKEY"
}
}
}
```
保存后，客户端会加载该 MCP Server 提供的工具。之后在对话中直接用自然语言描述需求即可，例如：
> 「用紫微斗数排盘，出生时间 1993-10-27 06，男性。」
AI 客户端会自动调用排盘工具并返回命盘数据（结构与 [返回字段全解](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647) 一致）。
## 返回示例与解析
经 MCP 返回的命盘依然是标准 JSON：`result` 含 `wx`（五行局）、`pan`（十二宫数组）等。AI 可进一步把主星、大限等字段组织成可读的命盘说明，但请注明属「传统文化研究参考，结果仅供参考」。
## 进阶 / 边界
- **AppKey 保护**：MCP 配置中的 AppKey 等同于接口密钥，仅在自己可信的客户端中使用，不要外泄或提交到公开仓库。
- **仅覆盖本接口接入点**：该 MCP Server 对应 apiCode=1647 的全部接入点；如需其他接口，需另行配置对应 MCP。
- **无批量/订阅**：MCP 暴露的仍是同步单条排盘能力，符合接口本身能力边界。
- **合规边界**：接口官方定位为研究参考工具，AI 生成的解读应标注「仅供参考」，避免算命式断言。
## FAQ
**Q1：MCP 和直接写代码调接口有什么区别？**
A：MCP 让 AI 客户端把接口当作「工具」直接调用，无需你写 HTTP 代码；直接调接口则更灵活，适合做网站/服务端集成。两者底层都是同一个排盘接口。
**Q2：哪些客户端支持？**
A：文档示例提及 Cherry Studio、ChatBox 等支持 MCP 的客户端；具体以你所用客户端的 MCP 配置方式为准。
**Q3：AppKey 泄露了怎么办？**
A：立即到 [AppKey 管理页](https://www.showapi.com/console#/myApp) 重置或停用该 Key，并检查是否有异常调用。
**Q4：MCP 调用返回的格式和文档一致吗？**
A：一致，都是标准 JSON（showapi_res_body 包裹 result）。字段含义见 [返回字段全解](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647)。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理紫微斗数接口](https://www.showapi.com/guides/ziwei-doushu-openapi-import-1647)
- [紫微斗数排盘API返回字段全解：五行局、十二宫、主星一文读懂](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647)
- [紫微斗数排盘API：5分钟接入，从注册到第一张命盘](https://www.showapi.com/guides/ziwei-doushu-quickstart-1647)
- **本系列共 12 篇**：查看[紫微斗数排盘 API 指南总目录](https://www.showapi.com/guides/ziwei-doushu-guides-1647)
