通过 MCP 在 AI 客户端直接调用黄历运势
黄历运势MCPAI客户端集成CherryStudio # 通过 MCP 在 AI 客户端直接调用黄历运势
> 接口 黄历运势（apiCode=856） · 免费服务 · 适用人群：AI 客户端/ChatBot 开发者 · 阅读时间约 6 分钟
## TL;DR
- 黄历运势提供**接口级 MCP 服务**，覆盖全部三个接入点（黄历/吉神凶煞/吉时）。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端里，填入一段 JSON 即可让 AI 直接调用。
- MCP 地址里的域名是 `www.showapi.com.cn`（注意不是 `.com`），且需把 `{your_appKey}` 替换为真实 AppKey。
## Why：为什么用 MCP 而不是直接写代码
把黄历运势挂成 MCP 工具后，AI 客户端（如 Cherry Studio、ChatBox）里的对话机器人就能「听懂」用户的自然语言请求——「查一下 2026 年 2 月 11 日的黄历宜忌」「今天什么时辰吉利」——并自动调用接口返回真实数据，无需你为每个意图手写解析代码。
## What：MCP 配置事实（来自接口文档）
| 项目 | 内容 |
|------|------|
| 集成级别 | 接口级（覆盖 856 全部接入点） |
| 配置方式 | 在支持 MCP 的客户端中填入 JSON |
| MCP 地址 | `http://www.showapi.com.cn/mcp/856/{your_appKey}` |
| 占位符 | `{your_appKey}` 替换为你的真实 AppKey |
| 获取 AppKey | [AppKey 管理](https://www.showapi.com/console#/myApp) |
> ⚠️ 文档给出的 MCP 域名是 `www.showapi.com.cn`（带 `.cn`），与官网 `www.showapi.com` 不同，配置时照抄文档原文。
## How：在客户端配置 MCP
### 步骤 1：复制并填入配置
把下面 JSON 中的 `{your_appKey}` 换成你的真实 AppKey，填入客户端的 MCP 配置处：
```json
{
"mcpServers": {
"showapi-mcp-856": {
"url": "http://www.showapi.com.cn/mcp/856/{your_appKey}"
}
}
}
```
### 步骤 2：在对话里使用
配置保存并连接后，直接对 AI 说：
- 「帮我查 2026-02-11 的黄历，今天宜什么忌什么？」
- 「2026 年 2 月 11 日哪个时辰最吉利？」
- 「查一下今天的财神方位和犯太岁生肖。」
AI 会自行选择对应接入点（856-2 / 856-3 / 856-4）并返回结果。
## 进阶 / 边界
- **覆盖全部接入点**：这一个 MCP 服务即可调用黄历、吉神凶煞、吉时三个接入点，无需分别配置。
- **AppKey 即凭证**：MCP 地址里直接带 AppKey，仅在**你自己可信的客户端**配置，不要分享该配置给他人。
- **免费仍占次数**：通过 MCP 调用同样占用账户按次调用次数（`ret_code=0` 扣除）。
- **没有订阅推送**：文档未提及订阅/回调类能力，MCP 为「请求—响应」式调用。
## FAQ
**Q1：MCP 地址为什么是 showapi.com.cn 而不是 showapi.com？**
A：这是接口文档原文给出的 MCP 服务域名，照抄即可；官网与文档站点是 `.com`，MCP 服务端点为 `.cn`，二者不同。
**Q2：支持哪些客户端？**
A：文档点名 Cherry Studio、ChatBox 等支持 MCP 的客户端；凡支持 `mcpServers` 标准配置的工具均可尝试。
**Q3：能和企业微信/飞书机器人接吗？**
A：取决于该平台是否支持 MCP 协议或自定义工具调用；本文仅覆盖标准 MCP 客户端配置。
## 相关能力 / 下一步阅读
- [导入 OpenAPI 文档：用 Apifox/Postman 管理黄历运势接口](https://www.showapi.com/guides/huangli-openapi-import-856) —— 另一种治理方式。
- [5 分钟接入黄历运势：从注册到第一条黄历数据](https://www.showapi.com/guides/huangli-quickstart-856) —— 非 AI 场景的直连调用。
- [黄历运势返回字段全解：黄历/吉神凶煞/吉时字段一文读懂](https://www.showapi.com/guides/huangli-response-fields-856) —— AI 返回字段的释义依据。
- **本系列共 11 篇**：查看[黄历运势指南总目录](https://www.showapi.com/guides/huangli-guides-856)
