内容
<div align="center">
<img src="https://qinisolabs.github.io/icdwise/logo.svg" width="96" height="96" alt="秦硕" />
# ICD智慧
**经过验证的ICD-10-CM代码查询与验证，用于AI代理 — 官方描述，非推测。**
*用于AI代理的可靠数据工具。 "Qiniso"在祖鲁语中意为"真相"。*
[官网](https://qinisolabs.github.io/icdwise/) · [npm](https://www.npmjs.com/package/icdwise) · [MCP服务端](https://icdwise.qinisolabs.workers.dev/mcp) · [MCP注册中心](https://registry.modelcontextprotocol.io/v0/servers?search=icdwise)
</div>
---
询问一个大型语言模型某个ICD-10-CM代码的含义，它可能会自信地回答 — 但往往是**错误的**：错误的侧向性、错误的严重程度、完全错误的病况，而且它可能会为不存在的代码编造描述。 **icdwise**直接从官方美国ICD-10-CM代码集中查询代码，返回真实的描述 — 或者诚实的 *"未找到"* 而不是猜测。
> 在询问关于真实ICD-10-CM代码的描述时，一个前沿模型如果没有工具，**错误率约为38%** — 例如，它将 `H40.1131` 称为 *"严重阶段，右眼"* （实际上是*轻度，双侧*），并将 `T63.011A` 称为 *"摄入蘑菇"* （实际上是*响尾蛇毒液*）— 而且它**为不存在的代码编造了描述**。 icdwise：官方文本，或"未找到"。从不猜测。
## 添加到Claude
设置 → 连接器 → **添加自定义连接器**，粘贴 — 无需登录，无需密钥：
```
https://icdwise.qinisolabs.workers.dev/mcp
```
无状态，不读取用户数据，无需密钥。更喜欢通过标准输入/输出在本地运行？在客户端配置文件中的 `mcpServers` 下添加 `{ "command": "npx", "args": ["-y", "icdwise"] }`。
## 作为库使用
```bash
npm i icdwise
```
```ts
import { lookupIcd10, validateIcd10, searchIcd10 } from "icdwise";
lookupIcd10("E11.9").description; // "2型糖尿病，无并发症"
lookupIcd10("H40.1131").description; // "原发性开角型青光眼，双侧，轻度阶段"
validateIcd10("E11.99").valid; // false — 格式正确但不是真实代码
searchIcd10("广泛性焦虑"); // → [{ code: "F41.1", description: "广泛性焦虑障碍" }, ...]
```
代码接受带或不带点（`E11.9` 或 `E119`）。格式正确的代码如果不在官方代码集中，返回 `found: false` 并附有明确说明 — 从不编造描述。
## 工具 — 3
| 工具 | 回答内容 |
| --- | --- |
| **lookup_icd10** | 代码的官方描述（+ 规范形式和3字符类别） |
| **validate_icd10** | 这是真实的ICD-10-CM代码吗？（格式正确 *且* 在官方代码集中） |
| **search_icd10** | 反向查找 — 按关键词查找病况的代码 |
## 数据
ICD-10-CM是美国**公共领域**数据（NCHS/CMS）。完整代码集（~74,000个代码）通过`npm run build-data <icd10cm-codes-YYYY.txt>`从官方CMS版本生成（参见`scripts/build-data.mjs`）；每个响应报告其使用的`datasetVersion`。描述是官方文本 — 经过整理的、版本化的数据集保持最新是核心竞争力。
## 它不是
- **不是医疗建议**，不是决定可报销性、覆盖范围或临床适当性。
- **不是ICD-10（WHO）或ICD-11** — 这是ICD-10-**CM**（美国临床修改版）。
- **不是猜测器** — 未知/已弃用/非叶子代码返回诚实的"未找到"，从不编造描述。
## 架构
单个TypeScript包，通过两个传输方式暴露一个MCP服务端 — **stdio**（本地 / `npx`）和 **Cloudflare Worker**（托管边缘端点）— 两个方式都由相同的`core.ts`工具定义驱动，它也为可导入的库提供支持。
```bash
npm install
npm run build
npm test
```
## 隐私
该工具在您的本地机器上运行，不收集、存储或传输您的数据 — 无分析，无遥测，无账户。所有参考数据都已捆绑 — 无网络调用，设备上没有任何数据离开。完整政策：<https://qinisolabs.github.io/privacy.html>.
## 许可证
Apache-2.0。ICD-10-CM数据是美国公共领域（NCHS/CMS）；参见`NOTICE`。
