节假日查询：通过 MCP 协议在 AI 客户端里直接调用
# 节假日查询：通过 MCP 协议在 AI 客户端里直接调用
> 接口 894（全部接入点，经 MCP 封装） · 免费 · MCP 协议 · 适用人群：AI 客户端用户 · 阅读时间：约 6 分钟
## TL;DR
- 节假日查询已提供官方 **MCP 服务**，覆盖全部 3 个接入点。
- 在 Cherry Studio、ChatBox 等支持 MCP 的客户端里贴一段 JSON 配置即可让 AI 直接答"今天放不放假"。
- 把 `{your_appKey}` 换成真实 AppKey 即可，无需写代码。
## Why：让 AI 直接查节假日
把节假日查询接成 MCP 工具后，你的 AI 客户端就能在对话里实时调用接口："五一放几天？""下周一补班吗？"——不用你手动查文档或写脚本。这正是 AI Agent + 工具调用的典型用法。
## What：MCP 配置（来自官方文档）
ShowAPI 提供的 MCP 配置（接口级，覆盖全部接入点）：
```json
{
"mcpServers": {
"showapi-mcp-894": {
"url": "http://www.showapi.com.cn/mcp/894/{your_appKey}"
}
}
}
```
> 把 `{your_appKey}` 替换为你在 ShowAPI 控制台拿到的真实 AppKey。
## How：在 AI 客户端里接入
### 步骤 1：拿到 AppKey
登录 ShowAPI 控制台 →「我的应用」复制 AppKey。
### 步骤 2：写入客户端 MCP 配置
以 Cherry Studio / ChatBox 为例，在 MCP 设置里新增一个 Server，粘贴上面的 JSON（替换 AppKey）。保存后客户端会拉取该 MCP 暴露的工具列表（对应 894-4 / 894-6 / 894-7）。
### 步骤 3：直接用自然语言问
配置生效后，直接对话：
- "2026 年劳动节放几天？" → AI 调 894-4 返回放假区间。
- "今天是不是节假日？" → AI 调 894-6 返回 `type`。
- "今年哪些天要补班？" → AI 调 894-7 返回调休日列表。
## 进阶 / 边界
- **覆盖全部接入点**：一个 MCP 配置即包含 894-4 / 894-6 / 894-7，无需分别配置。
- **鉴权在 URL 里**：AppKey 直接写在 MCP 地址中，注意保管、不要泄露。
- **免费但有档位限制**：AI 高频调用同样占用档位，必要时做缓存（见 [缓存策略](https://www.showapi.com/guides/holiday-query-cache-894)）。
## FAQ
**Q1：支持哪些客户端？**
A：任何支持 MCP 协议的客户端（如 Cherry Studio、ChatBox）均可，按上面 JSON 配置。
**Q2：MCP 和直接 HTTP 调用有什么区别？**
A：MCP 让 AI Agent 能"自己决定调用"，无需你手写代码；直接 HTTP 调用见各接入点指南。
**Q3：AppKey 写在 URL 安全吗？**
A：注意仅在可信客户端配置，不要分享含 AppKey 的配置。
**Q4：三个接入点都要单独配吗？**
A：不用，一个 MCP 配置覆盖全部接入点。
**Q5：能离线用吗？**
A：MCP 服务需要联网访问 ShowAPI，无法离线。
## 相关能力 / 下一步阅读
- [节假日查询：5 分钟接入，从注册到拿到全年放假安排](https://www.showapi.com/guides/holiday-query-quickstart-894)
- [节假日查询：导入 Postman / Swagger，用 OpenAPI 文档管理接口](https://www.showapi.com/guides/holiday-query-openapi-894)
- [节假日查询返回字段全解：ret_code 与 type(1/2/3) 及三接入点结构一文读懂](https://www.showapi.com/guides/holiday-query-response-codes-894)
- **本系列共 12 篇**：查看[节假日查询指南总目录](https://www.showapi.com/guides/holiday-query-guides-894)
