Skip to main content
Glama
fattank

CHS-DRG MCP Server

by fattank
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

CHS-DRG MCP Server

License Node MCP

面向中国医保 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 双版本对照，方便观察医保付费版本升级带来的分组差异；

  • 提供诊断 / 手术操作 编码检索 和 规则版本查询。

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

Related MCP server: autoicd-mcp

特性

特性

说明

标准 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • autoicd-mcp

    fcggamou
    A
    license
    A
    quality
    D
    maintenance
    MCP server for automated ICD-10 medical coding. Code clinical text to ICD-10-CM diagnoses, search 74,000+ codes, and de-identify PHI via the AutoICD API.
    6
    40 npm
    MIT

  • tcm-kb

    djp0417
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables MCP hosts to query a curated traditional Chinese medicine wellness knowledge base, run constitution assessments, identify intake information gaps, and obtain rule-based safety checks with five-tier risk conclusions.
    3
    MIT