icdwise

---

询问大模型某个 ICD-10-CM 代码的含义，它会自信地作答——而且往往答错：侧别错误、严重程度错误，甚至完全搞错病症；它还会为不存在的代码编造描述。icdwise 会在美国官方 ICD-10-CM 代码集中查询代码，并返回真实描述；如果查不到，就如实回答*“未找到”*，而不是猜测。

让一个没有使用工具的前沿模型描述真实的 ICD-10-CM 代码时，它有 约 38% 的回答是错误的——例如，它把 H40.1131 说成*“重度，右眼”（实际是轻度，双眼*），把 T63.011A 说成*“误食蘑菇”（实际是响尾蛇毒液*）——而且它还为一个不存在的代码编造了描述。icdwise：返回官方文本，或“未找到”，绝不猜测。

添加到 Claude

设置 → 连接器 → 添加自定义连接器，然后粘贴以下内容——无需登录，无需密钥：

https://icdwise.qinisolabs.workers.dev/mcp

无状态，不读取任何用户数据，也不需要机密信息。想通过 stdio 在本地运行？在客户端配置的 mcpServers 下添加 { "command": "npx", "args": ["-y", "icdwise"] }。

将其用作库

npm i icdwise

import { lookupIcd10, validateIcd10, searchIcd10 } from "icdwise";

lookupIcd10("E11.9").description;     // "Type 2 diabetes mellitus without complications"
lookupIcd10("H40.1131").description;  // "Primary open-angle glaucoma, bilateral, mild stage"
validateIcd10("E11.99").valid;        // false — well-formed but not a real code
searchIcd10("generalized anxiety");   // → [{ code: "F41.1", description: "Generalized anxiety disorder" }, ...]

代码可带点号或不带点号（E11.9 或 E119）。格式正确但不在官方代码集中的代码会返回 found: false，并附上清晰说明——绝不会编造描述。

工具 — 3 个

工具	用途
lookup_icd10	查询代码的官方描述（以及规范形式和 3 位类别）
validate_icd10	这是否为真实的 ICD-10-CM 代码？（格式正确，且存在于官方代码集中）
search_icd10	反向查询——根据病症关键词查找代码

数据

ICD-10-CM 是美国的公有领域数据（NCHS/CMS）。完整代码集（约 74,000 个代码）已随包提供，并通过官方 CMS 发布文件生成：npm run build-data <icd10cm-codes-YYYY.txt>（参见 scripts/build-data.mjs）；每次响应都会报告所用的 datasetVersion。描述采用官方文本——持续更新的精选版本化数据集正是其优势所在。

它不是什么

• 不是医疗建议，也不用于判定是否可计费、是否承保或是否符合临床要求。
• 不是 ICD-10 (WHO) 或 ICD-11——这是 ICD-10-CM（美国临床修订版）。
• 不是猜测工具——未知、已停用或非叶级代码会如实返回“未找到”，绝不编造描述。

架构

一个 TypeScript 包，通过两种传输方式提供同一个 MCP 服务——stdio（本地 / npx）和 Cloudflare Worker（托管的边缘端点）；两者都由同一套 core.ts 工具定义驱动，这些定义也为可导入的库提供支持。

npm install
npm run build
npm test

隐私

此工具在你的设备上本地运行，设计上不会收集、存储或传输你的数据——没有分析、没有遥测、无需账户。所有参考数据都随包提供——无需网络请求，任何数据都不会离开你的设备。完整政策：https://qinisolabs.github.io/privacy.html。

许可证

Apache-2.0。ICD-10-CM 数据属于美国公有领域（NCHS/CMS）；详见 NOTICE。