icd-mcp

ICD MCP 服务

让任何 AI 助手即时访问 WHO ICD-10 和 ICD-11 分类系统——这是全球诊断代码、医院账单和死亡统计所依据的标准。

12 个操作。两个 ICD 版本。一次工具调用。

https://mcp-icd.medseal.app/mcp

---

能做什么？

将临床文本自动编码为 ICD-11 代码

粘贴自由文本临床描述，即可获取正确的代码。不再需要手动查找。

{"action": "autocode", "query": "acute bronchitis with fever"}
→ CA20 Acute bronchitis (92.3% confidence)

{"action": "autocode", "query": "patient presents with chest pain and shortness of breath"}
→ MD81 Chest pain (87.1% confidence)

即时查询任何 ICD-10 或 ICD-11 代码

获取定义、编码说明、包含项、排除项——编码人员所需的一切信息。

{"action": "lookup", "code": "BA00"}
→ BA00: Lobar pneumonia — full definition, coding notes, inclusions/exclusions

{"action": "lookup", "code": "J18.9", "version": "10"}
→ J18.9: Pneumonia, unspecified (ICD-10)

按关键词搜索

不知道代码？描述一下，即可获取排序后的结果。

{"action": "search", "query": "type 2 diabetes with kidney complications"}
→ Ranked ICD-11 results with codes and titles

{"action": "search", "query": "melanoma", "chapter": "02", "max_results": 5}
→ Filtered to neoplasm chapter

像浏览树状结构一样浏览分类

交互式导航——查看任意代码的父级、子级，以及它在层级结构中的位置。

{"action": "browse"}
→ All 28 ICD-11 chapters (or 21 ICD-10 chapters)

{"action": "browse", "code": "BA00"}
→ Parent context + sub-categories with ▸ expansion markers

追溯代码的完整层级路径

从任意叶级代码一路向上追溯到章节根节点。

{"action": "ancestors", "code": "BA01.0"}
→ BA01.0 → BA01 → BA0Y-BA2Z → Diseases of the respiratory system → Chapter 12

即时验证代码

快速判断——这是有效代码吗？它是叶级代码还是类别？

{"action": "validate", "code": "BA00"}
→ Valid ICD-11 code, category level, has sub-codes

{"action": "validate", "code": "XYZ99"}
→ Not a valid ICD-11 code

内置编码规则参考

无需离开对话即可查阅编码指南。

{"action": "coding_rules", "topic": "extension_codes"}
→ Full guide to ICD-11 severity, temporality, anatomy, histopathology codes

{"action": "coding_rules", "topic": "clustering"}
→ How to combine codes with & and / operators

{"action": "coding_rules", "topic": "dagger_asterisk"}
→ ICD-10 etiology/manifestation dual coding system

可用主题：extension_codes、clustering、sequencing、dagger_asterisk、postcoordination

全面了解

概览各分类系统——章节表、关键概念和差异。

{"action": "overview"}
→ ICD-11: 28 chapters, postcoordination, extension codes, what changed from ICD-10

{"action": "overview", "version": "10"}
→ ICD-10: 21 chapters, code ranges, dagger/asterisk system

---

12 个操作一览

操作	功能	ICD-10	ICD-11
lookup	完整代码详情和定义	是	是
search	按关键词查找代码	-	是
autocode	临床文本 → 最匹配的代码	-	是
browse	交互式浏览层级结构	是	是
chapters	列出所有分类章节	是	是
children	获取任意代码下的子代码	是	是
ancestors	向上追溯层级路径至章节根节点	是	是
validate	检查代码是否存在及其级别	是	是
coding_rules	编码规范参考	是	是
overview	分类系统概览	是	是
api	WHO API 原始访问	是	是
help	操作参考和示例	-	-

---

适用对象

• 医疗 IT 开发者：构建临床应用、EHR 或编码工具
• 医学编码人员：希望借助 AI 查找和验证代码
• 健康数据分析师：探索分类结构
• 研究人员：处理 WHO 死亡率／发病率数据
• AI／大模型构建者：为 Agent 添加医学编码能力
• 任何正在从 ICD-10 过渡到 ICD-11 的人：需要并排使用这两个系统

---

快速开始

使用托管服务（最快）

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "icd": {
      "type": "url",
      "url": "https://mcp-icd.medseal.app/mcp"
    }
  }
}

也可以通过 https://mcp-icd.medseal.app/mcp 连接任何兼容 MCP 的客户端。

部署自己的服务

1. 克隆并安装：

   git clone https://github.com/stayce/icd-mcp-cloudflare
   cd icd-mcp-cloudflare
   npm install
   

2. 获取 WHO API 凭据（免费）：

   • 在 https://icd.who.int/icdapi 注册
   • 获取 Client ID 和 Secret

3. 设置密钥并部署：

   wrangler secret put WHO_CLIENT_ID
   wrangler secret put WHO_CLIENT_SECRET
   npm run deploy
   

就是这样。服务运行在 Cloudflare 的全球边缘网络上。

---

为什么选择这个 MCP？

节省 token。 一个工具，12 项操作。精简工具列表，不占用上下文窗口。

同时支持两个 ICD 版本。 ICD-10 仍在各地用于计费。ICD-11 是未来趋势。你需要两个版本。默认使用 ICD-11；添加 "version": "10" 即可使用 ICD-10。

WHO 官方数据。 数据直接来自 WHO ICD-API，而非过时副本或抓取的数据集。

自动编码名副其实。 使用 WHO 自有的自动编码引擎，而非基于关键词的取巧方案。提供临床文本，即可获得正确代码。

零冷启动。 使用 Cloudflare Workers，而非容器。全球响应时间低于 50 毫秒。

---

ICD-10 与 ICD-11

	ICD-10	ICD-11
采用年份	1990	2019
代码数量	约 14,400	约 17,000
格式	A00.0–Z99.9	BA00, 1A00.1
搜索	WHO API 不支持	全文搜索 + flexisearch
自动编码	不支持	支持
主要特点	剑号/星号双重编码	后协调 + 扩展代码
状态	仍是计费领域的主流	自 2022 年 1 月起正式生效

此服务默认使用 ICD-11，同时全面支持两个版本。查询 ICD-10 时使用 "version": "10"。

---

MedSeal MCP 套件的一部分

服务	分类	链接
ICD MCP（本服务）	WHO ICD-10/ICD-11 诊断代码	icd-mcp-cloudflare
ICF MCP	WHO ICF 功能与残疾分类	icf-mcp-cloudflare
Part D MCP	CMS Medicare Part D 药品支出	partd-mcp-cloudflare

全部部署在 Cloudflare Workers 上。全部开源。全部兼容 MCP。

---

许可证

MIT