icdwise 是一个面向 AI 智能体的 ICD-10-CM 代码查询与验证工具，旨在解决大语言模型在回答医疗代码含义时经常出错甚至编造描述的问题。根据官方说明，一个没有工具辅助的前沿模型在描述真实 ICD-10-CM 代码时错误率约为 38%，例如将 H40.1131 错误描述为“严重阶段，右眼”（实际为轻度，双侧），将 T63.011A 错误描述为“摄入蘑菇”（实际为响尾蛇毒液），并且会为不存在的代码编造描述。icdwise 通过查询官方美国 ICD-10-CM 代码集来返回真实描述，或者诚实返回“未找到”，绝不猜测。
主要能力：
- 代码查询与验证：接受带点或不带点的代码（如 E11.9 或 E119），在官方代码集中查找并返回官方描述。
- 诚实反馈：格式正确但不在官方集中的代码返回 found: false 并附明确说明，不会编造描述。
- 数据版本报告：每次响应都会报告所使用的 datasetVersion。
- 完整数据集：约 74,000 个代码已打包，数据从官方 CMS 发布版本生成。
使用方式：
- 作为 MCP 服务器：可添加到 Claude 中，通过“设置 → 连接器 → 添加自定义连接器”粘贴端点，无需登录或密钥。也可在客户端配置的 mcpServers 下添加 { "command": "npx", "args": ["-y", "icdwise"] } 以通过 stdio 在本地运行。
- 作为库：该 TypeScript 包暴露一个 MCP 服务器，支持 stdio（本地/npx）和 Cloudflare Worker（托管边缘端点）两种传输方式，两者由相同的 core.ts 工具定义驱动，这些定义也支持可导入的库。
适用场景：
- AI 智能体需要准确查询或验证 ICD-10-CM 代码时。
- 开发者在应用中集成医疗代码查询功能时。
- 需要避免大模型在医疗代码上产生幻觉的场景。
限制与注意事项：
- 不提供医疗建议，不判断可计费性、覆盖范围或临床适当性。
- 不是 ICD-10（WHO）或 ICD-11，而是美国临床修订版 ICD-10-CM。
- 未知、已停用或非叶子代码返回诚实的“未找到”，绝不编造描述。
- 工具在本地运行，不收集、存储或传输数据，无分析、无遥测、无账户，所有参考数据本地打包，无网络调用。
- 采用 Apache-2.0 许可，ICD-10-CM 数据为美国公共领域数据（NCHS/CMS）。
