通过 MCP 在 Cherry Studio / ChatBox 中直接调用常见疾病查询
# 通过 MCP 在 Cherry Studio / ChatBox 中直接调用常见疾病查询
> 接口：常见疾病查询（apiCode=546）· 免费 · MCP 服务 · 返回格式 JSON · 适用人群：AI Agent / MCP 开发者 · 阅读时间：约 5 分钟
## 核心要点
- 常见疾病查询提供官方 **MCP 服务**，覆盖全部 3 个接入点，URL：`http://www.showapi.com.cn/mcp/546/{your_appKey}`。
- 在支持 MCP 的 AI 客户端（Cherry Studio、ChatBox 等）配置后，Agent 可直接"查疾病科目/检索疾病/取明细"，作为知识工具。
- 配置只需把 `{your_appKey}` 换成你的真实 AppKey，**无需自己写调用代码**。
## Why：让 AI 助手拥有"疾病知识"
当你在搭一个医疗问答/导诊 Agent，你希望它回答"高血压挂什么科""糖尿病有什么症状"时，能实时查权威数据，而不是凭训练记忆瞎编。MCP 把常见疾病查询变成 Agent 的一个"工具"，模型按需调用，拿回结构化结果再组织回答，准确度和时效性都更好。
## What：MCP 配置信息
| 项 | 值 |
|----|----|
| 协议 | MCP（Model Context Protocol） |
| 服务地址 | `http://www.showapi.com.cn/mcp/546/{your_appKey}` |
| 覆盖范围 | 546-1 查询疾病科目 / 546-2 关键字查询疾病 / 546-3 取得疾病明细 |
| 鉴权 | AppKey 拼在 URL 路径中 |
## How：在 AI 客户端配置
### MCP JSON 配置
```json
{
"mcpServers": {
"showapi-mcp-546": {
"url": "http://www.showapi.com.cn/mcp/546/{your_appKey}"
}
}
}
```
> 把 `{your_appKey}` 替换为你在[易源控制台](https://www.showapi.com/console#/myApp)拿到的真实 AppKey。
### 在 Cherry Studio / ChatBox 中
1. 打开客户端的 **MCP 设置 / 工具服务器** 配置页。
2. 新增一个 MCP Server，粘贴上面的 JSON（含真实 AppKey）。
3. 保存并连接，确认 `showapi-mcp-546` 显示为已连接、并列出 3 个工具（对应 546-1/546-2/546-3）。
4. 在对话中让 Agent「查一下高血压挂哪个科 / 高血压有什么症状」，Agent 会自动调用对应工具。
### 调用效果（模型视角）
Agent 可用自然语言触发，例如：
- "列出所有一级科室" → 调用 546-1
- "搜一下'糖尿病'相关的疾病" → 调用 546-2（key=糖尿病）
- "给我糖尿病的症状、诊断、治疗、预防" → 调用 546-2 拿 id → 546-3 取 `tagList`
## 返回示例与解析
MCP 工具返回的就是接口原生 JSON（见[返回字段全解](https://www.showapi.com/guides/disease-query-response-fields-546)），Agent 可直接消费 `list`/`contentlist`/`item`/`tagList` 等结构。
## 进阶 / 边界
- **AppKey 安全**：MCP URL 里含 AppKey，仅配在**你本人信任的客户端**本地，勿外泄或提交到公开仓库。
- **适用场景**：MCP 适合"AI 对话中按需查"，不适合高并发批处理（批处理见[知识库搭建](https://www.showapi.com/guides/disease-query-health-kb-546)）。
- **非诊疗**：Agent 回答时务必带"仅供参考，不能替代医生诊断"的免责。
- **覆盖全部接入点**：一个 MCP 服务即含 546-1/546-2/546-3，无需分别配置。
## FAQ
**Q1：MCP 和直接调 API 有什么区别？**
A：MCP 让 AI 客户端/Agent 以"工具"形式自动调用，无需你写请求代码；底层仍是同一套接口。
**Q2：AppKey 写在 URL 里安全吗？**
A：仅限本地可信客户端使用，注意保密，不要提交到公开代码仓库。
**Q3：哪些客户端支持？**
A：文档点名 Cherry Studio、ChatBox 等支持 MCP 的客户端；具体以客户端版本为准。
**Q4：能只暴露某个接入点吗？**
A：官方提供的是覆盖全部接入点的统一 MCP 服务，无法在配置层单独限定。
## 相关能力 / 下一步阅读
- [导入 Postman / Swagger：用 OpenAPI 文档管理常见疾病查询接口](https://www.showapi.com/guides/disease-query-openapi-546)
- [常见疾病查询返回字段全解：科目树、疾病列表与明细结构一文读懂](https://www.showapi.com/guides/disease-query-response-fields-546)
- [常见疾病查询：5 分钟从注册到拿到第一篇疾病明细](https://www.showapi.com/guides/disease-query-quickstart-546)
- **本系列共 12 篇**：查看[常见疾病查询指南总目录](https://www.showapi.com/guides/disease-query-guides-546)
