通过 MCP 在 AI 客户端直接调用测吉凶（Cherry Studio / ChatBox）

# 通过 MCP 在 AI 客户端直接调用测吉凶（Cherry Studio / ChatBox） > 接口/接入点：测吉凶 apiCode=1617（MCP 覆盖全部 4 个接入点） · 免费服务 · 适用人群：AI/MCP 开发者 · 阅读时间：约 6 分钟 ## 核心要点 - 测吉凶官方提供 MCP 服务，配置后可在支持 MCP 的 AI 客户端里**直接用自然语言调用**四个接入点。 - MCP 配置只需一段 JSON，把 `{your_appKey}` 换成真实 AppKey 即可，无需写代码。 - 适合做 AI 助手的能力扩展：用户说「测一下我手机号吉凶」，AI 自动调接口返回。 ## Why：蹭上 MCP / AI Agent 热点 MCP（Model Context Protocol）让大模型直接「会用工具」。把测吉凶接成 MCP，你的 AI 客户端就多了一个「趣味占卜」技能，无需自己写调用代码，配置即用。 ## What：MCP 接入信息 | 项 | 说明 | |------|------| | MCP 服务名 | `showapi-mcp-1617` | | MCP 地址 | `http://www.showapi.com.cn/mcp/1617/{your_appKey}` | | 覆盖范围 | 本接口全部 4 个接入点（手机号/车牌号/QQ/公司名） | | 适用客户端 | Cherry Studio、ChatBox 等支持 MCP 的客户端 | ## How：在客户端配置 MCP 复制下面 JSON，把 `{your_appKey}` 替换成你的真实 AppKey（[控制台获取](https://www.showapi.com/console#/myApp)）： ```json { "mcpServers": { "showapi-mcp-1617": { "url": "http://www.showapi.com.cn/mcp/1617/{your_appKey}" } } } ``` 在 Cherry Studio / ChatBox 的 MCP 设置中「添加服务器」→ 粘贴上述配置 → 保存并启用。启用后，对话里直接说「测一下手机号 13770000000 的吉凶」，AI 会经 MCP 调用 1617-1 并返回 `expList` 内容。 ## 返回示例与解析 MCP 调用后，AI 客户端拿到的业务数据与普通 HTTP 调用一致，都在 `showapi_res_body.expList`（字符串数组）。例如 1617-1： ``` 号码：13770000000 数理：第81数 签语：最极之数，还本归元，能得繁业，发达成功 吉凶：吉 详解：主人的性格类型：[自我牺牲/性格被动型]… ``` AI 可把这些条目转述给用户；你也可让 AI 先按[expList 结构化解析](https://www.showapi.com/guides/fortune-expList-parse-1617)拆字段再组织语言。 ## 进阶 / 边界 - **MCP 地址用 `showapi.com.cn` 且为 http**：这是官方文档给出的 MCP 端点（与 `route.showapi.com` 的 REST 地址不同），照文档配置即可。 - **AppKey 写在 MCP URL 里**：相当于把密钥交给客户端本地保存，仅限自用/可信环境；共享客户端前注意清理。 - **结果与 REST 完全一致**：MCP 只是调用方式的封装，返回结构、空 expList 边界（公司名）都相同，见[公司名专篇](https://www.showapi.com/guides/fortune-company-guide-1617)。 - 若客户端要求 https，以官方文档/客户端提示为准，不自行臆改协议。 ## FAQ **Q：MCP 和直接 HTTP 调用有什么区别？** 能力完全相同，MCP 只是让 AI 客户端能「自然语言触发」调用，省去你写请求代码。返回结构一致。 **Q：MCP 地址为什么是 showapi.com.cn 且 http？** 这是官方文档提供的 MCP 端点（与 REST 的 route.showapi.com 不同）。按文档配置；若客户端强制 https，以官方/客户端提示为准。 **Q：四个接入点都要分别配 MCP 吗？** 不需要。一个 `showapi-mcp-1617` 覆盖全部 4 个接入点，AI 会根据你的自然语言选择对应接入点。 **Q：公司名走 MCP 也会空结果吗？** 会，与 REST 一致（可能仅返 ret_code+remark 无 expList），AI 端应做空态提示。 ## 相关能力 / 下一步阅读 - [导入 Postman / Swagger：用 OpenAPI 文档管理测吉凶接口](https://www.showapi.com/guides/fortune-openapi-import-1617) - [测吉凶：5 分钟接入指南（手机号/车牌号/QQ号/公司名）](https://www.showapi.com/guides/fortune-quickstart-1617) - [公司名测吉凶：接入点与「返回空 expList」边界说明](https://www.showapi.com/guides/fortune-company-guide-1617) - **本系列共 13 篇**：查看[测吉凶指南总目录](https://www.showapi.com/guides/fortune-guides-1617)