CHS-DRG MCP Server

面向中国医保 CHS-DRG 2.0 / 3.0 的 MCP 服务端。 输入住院病案首页编码，返回确定性的 MDC / ADRG / DRG 分组结果与分组依据。 可被 WorkBuddy、CodeBuddy、Claude、Cursor 等任何支持 MCP 的客户端直接调用。

English | 简体中文

---

这是什么

一个标准、轻量的 MCP 连接器，把 DRG 病案分组能力以工具（Tool）的形式暴露给 AI 智能体：

• 一份病案首页（主要诊断 + 手术操作 + 年龄/性别/体重等）→ 返回 MDC / ADRG / DRG、严重度、分组状态和每一步分组依据；
• 同时支持 2.0 与 3.0 双版本对照，方便观察医保付费版本升级带来的分组差异；
• 提供诊断 / 手术操作 编码检索 和 规则版本查询。

核心分组算法在独立的服务端运行，本仓库只是标准协议适配层，不包含任何分组规则或算法实现。

特性

| 特性 | 说明 | | --- | --- | | 标准 MCP 协议 | 支持 Streamable HTTP（2025-03-26 / 2025-06-18）与 HTTP+SSE（2024-11-05）两种传输 | | 双版本分组 | CHS-DRG 2.0 与 3.0 独立规则，支持并排对照 | | 确定性结果 | 返回 status 区分 grouped / needs-data / invalid / ungrouped / qy，不臆造结果 | | 分组依据 | 每个结果附带 trace，展示 MDC → ADRG → 严重度 → DRG 的判定过程 | | 零第三方依赖 | 仅需 Node.js ≥ 20，无 npm install | | 远程优先 | 无需本地安装，直接连接托管端点即可使用 |

快速开始

方式一：连接托管端点（推荐）

本项目已部署为远程 MCP 服务，无需安装任何东西，把你的 MCP 客户端指向：

SSE 端点：         http://47.109.152.150:4174/sse
Streamable HTTP：  http://47.109.152.150:4174/mcp
健康检查：         http://47.109.152.150:4174/health

目前为演示用的 IP + HTTP 端点，生产环境建议使用 HTTPS 域名（见 部署文档）。

WorkBuddy / CodeBuddy：在「连接器 / MCP 服务管理」中添加自定义 MCP：

{
  "mcpServers": {
    "chs-drg-grouper": {
      "type": "sse",
      "url": "http://47.109.152.150:4174/sse"
    }
  }
}

Claude Desktop / Cursor（仅支持本地 stdio 的客户端，用 mcp-remote 桥接）：

{
  "mcpServers": {
    "chs-drg-grouper": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://47.109.152.150:4174/sse"]
    }
  }
}

方式二：自建

git clone https://github.com/fattank/chs-drg-mcp.git
cd chs-drg-mcp

# 指向你自己的 DRG 分组服务
DRG_API_BASE=https://your-drg-service.example.com MCP_PORT=4174 node mcp-server.mjs

自建需要一个可用的上游 DRG 分组服务；若只想直接使用分组能力，请用方式一。

提供的工具

| 工具 | 作用 | 必填参数 | | --- | --- | --- | | drg_group_case | CHS-DRG 3.0 单病例分组 | principalDiagnosis | | drg_compare_versions | CHS-DRG 2.0 / 3.0 双版本对照 | principalDiagnosis | | drg_group_batch | CHS-DRG 3.0 批量分组（≤ 10 份） | cases[].principalDiagnosis | | drg_mapping_query | 国临版→医保版编码映射查询（含医保灰码） | 无（可按 kind/query/grayOnly 过滤） | | drg_search_code | 诊断 / 手术操作编码检索 | query | | drg_service_info | 服务状态与规则版本 | 无 |

完整参数说明见 docs/tools.md。

病案字段

| 字段 | 类型 | 说明 | | --- | --- | --- | | principalDiagnosis | string | 必填，主要诊断编码。医保版 ICD-10，或国临版（配合 useMapping=true），如 E10.300x051+H42.0* | | otherDiagnoses | string[] | 其他诊断编码 | | principalProcedure | string | 主要手术或操作编码。医保版 ICD-9-CM-3，或国临版（配合 useMapping=true） | | otherProcedures | string[] | 其他手术或操作编码 | | sex | M / F | 性别 | | ageYears | number | 周岁 | | ageDays | integer | 天龄（新生儿） | | birthWeightGrams | integer | 出生体重（克），2.0 早产儿分组使用 | | admissionWeightGrams | integer | 入院体重（克），3.0 早产儿分组使用 | | ventilationHours | number | 呼吸机使用时长（小时） | | dischargeDisposition | string | 离院方式 | | useMapping | boolean | 是否先用「国临版→医保版」对照表映射诊断/手术编码再分组；国临版输入设为 true | | caseId | string | 病案标识（可选） |

使用示例

单病例分组

请调用 drg_group_case：主要诊断 E10.300x051+H42.0*，女性，75 岁。

【CHS-DRG 3.0】已确定分组
  MDC：MDCC 眼疾病及功能障碍
  ADRG：CV1 各种类型青光眼
  DRG：CV1H 各种类型青光眼，大于等于 70 岁
  严重度：NONE

双版本对照

对比这个病案在 2.0 和 3.0 的分组差异：主要诊断 P07.200，女，出生 10 天，出生体重 1200g，入院体重 1200g。

【CHS-DRG 2.0】已确定分组
  ADRG：PS1 极度发育不全（出生体重＜1500g）
  DRG：PS15 极度发育不全（出生体重＜1500g），不伴严重合并症或并发症

【CHS-DRG 3.0】已确定分组
  ADRG：PS2 极度发育不全（入院体重 1000-1499g）
  DRG：PS29 极度发育不全（入院体重 1000-1499g）

【差异】两版结果存在差异，请对照病组名称与规则轨迹。

配置

| 环境变量 | 默认值 | 说明 | | --- | --- | --- | | DRG_API_BASE | http://127.0.0.1:4173 | 上游 DRG 分组服务地址 | | DRG_API_TIMEOUT_MS | 20000 | 上游调用超时（毫秒） | | MCP_HOST | 0.0.0.0 | 监听地址 | | MCP_PORT | 4174 | 监听端口 | | DRG_MCP_AUTH_TOKEN | 空 | 设置后启用 Authorization: Bearer <token> 鉴权 | | TLS_CERT / TLS_KEY | 空 | 同时设置时以 HTTPS 启动 |

访问日志（可选，默认开启）

自托管时，连接器会记录自身收到的调用：时间、调用方 IP、每日轮换的访客ID、方法、路径、状态、耗时、User-Agent、会话ID，MCP 握手自报的客户端平台名（clientInfo.name），以及 JSON-RPC 的方法名（initialize / tools/call / tools/list …）与调用成败计数（calls / callSuccesses / callFailures）。

不记录 JSON-RPC 的 params 与正文，因此不会落下任何病案内容；但日志确实会保存调用方原始 IP、UA 和会话ID，属于个人信息，请按需保留与清理。

• 位置：<连接器>/logs/access-YYYY-MM-DD.jsonl；目录权限 0700，文件 0600，按天分文件。
• 只落本机，连接器未提供任何读取日志的接口；logs/ 已在 .gitignore 中忽略，不会随仓库分发。
• 渠道归因：workbuddy（WorkBuddy / CodeBuddy 等）、github（Claude / Cursor 等）、unknown、probe（/health 探活扫描，不计入使用量）。规则是启发式的，改 src/access-log.mjs 里的 classifyPlatform 即可；日志同时保留平台原始名 client。
• 平台名通过独立的会话表保存，建立服务端流连接或断开都不会丢失归因。
• 调用上游时带 X-DRG-Client 标记头，便于上游分组服务的日志区分来源连接器。
• 批量请求（一个 JSON-RPC 数组里多次 tools/call）逐条累计，不会漏计；请求与响应按 id 的原始类型配对，同一批里 id:1 与 id:"1" 不会被合并。
• 调用失败不算使用：工具不存在返回 -32602、或 result.isError 为真时记入 callFailures；这类请求 HTTP 仍是 200，只看状态码会误判。响应未送达（断连，status=0）单独归为"未送达"。
• 尝试次数在执行工具之前就登记，所以客户端中途断开也会留下记录（归入"未送达"），不会整条丢失；没有 JSON-RPC 结果的请求（/health 探活、404）同样照常记录。
• 写入本身是异步的；只有新建/重建日志文件时才做一次同步可写性探测，持续故障时按 DRG_ACCESS_LOG_RETRY_MS（默认 5000ms）限流，不会每个请求都探测。故障排除后最多等一个冷却周期即自动重建，无需重启。

| 环境变量 | 默认值 | 说明 | | --- | --- | --- | | DRG_MCP_ACCESS_LOG | 未设置 | 只要被显式设置就优先：off 只关连接器，on 强制开启 | | DRG_ACCESS_LOG | 开 | 设为 off 时，若未显式设置 DRG_MCP_ACCESS_LOG，分组器与连接器一起关 | | DRG_MCP_ACCESS_LOG_DIR | <连接器>/logs | 日志目录 | | DRG_MCP_ACCESS_LOG_TZ | Asia/Shanghai | 分日时区 | | DRG_ACCESS_LOG_RETRY_MS | 5000 | 写入失败后同步探测的冷却时间 | | DRG_MCP_TRUST_PROXY | 关 | 位于 Nginx 等反向代理之后才开启 | | DRG_ACCESS_SALT | 自动生成 logs/.salt | 访客ID哈希盐 | | DRG_CLIENT_ID | chs-drg-mcp | 调用上游时携带的 X-DRG-Client 标记 |

开关优先级实测：DRG_ACCESS_LOG=off DRG_MCP_ACCESS_LOG=on 时连接器仍会记录。 想两头都关，设 DRG_ACCESS_LOG=off 且不要设置 DRG_MCP_ACCESS_LOG。启动横幅会打印实际状态。

统计口径：只有调用成功的 tools/call 才算使用量，握手、列工具、ping、404/鉴权失败与失败的调用都不计入。

安全与隐私

• 不含算法：本仓库不包含任何 DRG 分组规则、编码表或计算逻辑，分组在独立服务端完成。
• 不存储病案：连接器仅做内存中的请求转发，不落库、不记录病案正文；访问日志只写请求元数据（时间/IP/路径/状态/UA），不含请求体。
• 最小数据：只接收分组所必需的编码与患者基本字段。
• 不含支付信息：不返回费率、支付标准或结算金额。
• 建议鉴权：公开部署时请设置 DRG_MCP_AUTH_TOKEN，并全链路使用 HTTPS。

发现安全问题请见 SECURITY.md。

免责声明

本项目为病案分组计算工具，依据国家医保局公开的 CHS-DRG 分组方案实现，仅供医院病案、医保、质控人员核对分组结果使用，不构成任何结算、支付或法律意见。分组结果以医保经办机构最终认定口径为准。使用本项目不代表获得任何官方认证。

部署

见 docs/self-hosting.md（systemd + Nginx HTTPS 反向代理示例在 deploy/）。

参与贡献

见 CONTRIBUTING.md。

许可证

Apache License 2.0 © 2026 fattank

联系方式

• 微信：扫描下方二维码添加（请备注「DRG」）
• 问题与建议：GitHub Issues

<img src="./assets/wechat-qrcode.png" alt="微信二维码" width="260" />