npm package: @medical-mcp/egfr-calc-mcp-server
Description: eGFR和肌酐清除率计算器 - MCP Server
Author: Andy
Latest version: 1.0.9

# eGFR肌酐清除率计算器 MCP Server

> 基于 MCP (Model Context Protocol) 协议的eGFR和肌酐清除率计算工具服务器

## 📋 功能特性

本 MCP Server 提供以下医疗计算工具：

### eGFR 估算肾小球滤过率计算

- **中国修订MDRD方程 (c-MDRD)**: 针对中国人群验证的eGFR计算
- **湘雅方程2019**: 中国多中心开发和外部验证的eGFR方程
- **CKD-EPI 2021**: 国际标准的eGFR方程（肌酐，无种族变量）
- **CKD-EPI 2021组合方程**: 肌酐+胱抑素C高精度评估

### 肌酐清除率计算

- **Cockcroft-Gault公式**: 用于药品说明书兼容的肌酐清除率
- **24小时尿肌酐清除率**: 实测肌酐清除率计算

### 临床分期工具

- **CKD分期**: 慢性肾脏病G1-G5分期和A1-A3风险分层
- **AKI分级**: 急性肾损伤KDIGO标准分期

### 辅助计算工具

- **体表面积计算**: Mosteller公式BSA计算
- **肌酐单位转换**: μmol/L ↔ mg/dL 单位转换
- **eGFR去指数化**: 用于药物剂量调整的非标化GFR

## 🚀 快速开始

### 前置要求

- Node.js 18+
- TypeScript 5.0+

### 安装配置

#### 方式一：直接使用 npx（推荐）

```bash
npx @medical-mcp/egfr-calc-mcp-server
```

#### 方式二：全局安装

```bash
npm install -g @medical-mcp/egfr-calc-mcp-server
egfr-calc-mcp-server
```

#### 方式三：本地项目使用

```bash
npm install @medical-mcp/egfr-calc-mcp-server
npx @medical-mcp/egfr-calc-mcp-server
```

### Claude Desktop 集成

在 Claude Desktop 配置文件中添加：

```json
{
  "mcpServers": {
    "egfr-kidney-function": {
      "command": "npx",
      "args": ["@medical-mcp/egfr-calc-mcp-server"]
    }
  }
}
```

**配置文件位置：**

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

## 📖 工具使用指南

### eGFR计算 - 中国修订MDRD

**功能说明**: 使用中国修订MDRD方程计算eGFR，适用于中国成人人群

**使用示例**:

```
请帮我计算eGFR，患者信息如下：
- 年龄：65岁
- 性别：男
- 血清肌酐：95 μmol/L
- 身高：170cm
- 体重：70kg
```

**输出格式**:

- eGFR标准化值 (mL/min/1.73m²)
- eGFR去指数化值 (mL/min) 用于药物剂量调整
- 体表面积计算结果
- 临床意义解释和风险分层
- 注意事项和警告
- 相关医学参考文献

### eGFR计算 - 湘雅方程

**功能说明**: 使用湘雅方程2019计算eGFR，基于中国多中心数据开发

**使用示例**:

```
使用湘雅方程计算eGFR：
- 年龄：55岁
- 性别：女
- 血清肌酐：1.2 mg/dL
```

### 肌酐清除率 - Cockcroft-Gault

**功能说明**: 计算肌酐清除率，用于药品说明书兼容性

**使用示例**:

```
计算肌酐清除率，用于药物剂量调整：
- 年龄：72岁
- 性别：男
- 体重：60kg
- 身高：165cm
- 血清肌酐：1.3 mg/dL
- 体重类型：actual
```

### CKD分期

**功能说明**: 根据eGFR和尿白蛋白/肌酐比值进行CKD分期和风险分层

**使用示例**:

```
进行CKD分期评估：
- eGFR：58 mL/min/1.73m²
- 尿白蛋白/肌酐比值：120 mg/g
```

### AKI分级

**功能说明**: 根据KDIGO标准进行急性肾损伤分期

**使用示例**:

```
评估AKI分期：
- 基线肌酐：80 μmol/L
- 当前肌酐：140 μmol/L
- 距离基线时间：36小时
- 尿量：0.4 mL/kg/hr
- 尿量监测时长：8小时
```

## ⚠️ 免责声明

本工具仅供医疗专业人员参考使用，不能替代临床判断。使用前请：

1. 验证患者信息的准确性
2. 结合其他临床指标综合分析
3. 遵循相关医疗指南和规范
4. 在有疑问时咨询专科医生

## 🔧 开发说明

### 项目结构

```
src/eGFR-mcp-server/
├── package.json      # 项目配置
├── tsconfig.json     # TypeScript配置
├── src/
│   ├── types.ts      # 类型定义
│   └── index.ts      # 服务器主文件（包含所有逻辑）
├── README.md         # 说明文档
├── README_EN.md      # 英文说明文档
└── examples.md       # 使用示例
```

### 支持的计算方程

| 方程名称        | 适用人群   | 优势         | 注意事项         |
| --------------- | ---------- | ------------ | ---------------- |
| 中国修订MDRD    | 中国成人   | 中国人群验证 | 需IDMS标化肌酐   |
| 湘雅方程2019    | 中国成人   | 多中心验证   | 相对较新         |
| CKD-EPI 2021    | 国际成人   | 国际标准     | 中国人群可能偏高 |
| CKD-EPI Cr-CysC | 高精度需求 | 准确度高     | 需胱抑素C检测    |

### 肌酐单位支持

- **μmol/L**: 中国大陆常用单位
- **mg/dL**: 国际通用单位
- 自动转换系数：μmol/L ÷ 88.4 = mg/dL

### 临床应用场景

1. **门诊筛查**: 慢性病患者肾功能评估
2. **用药决策**: 肾排药物剂量调整
3. **病程监测**: CKD进展评估和随访
4. **围手术期**: 术前肾功能基线评估
5. **急诊科**: AKI快速识别和分期
6. **科研应用**: 肾功能相关研究数据分析

## 📚 参考文献

1. **中国修订MDRD**: Am J Kidney Dis. 2006;48(1):e5-e11
2. **湘雅方程**: Am J Kidney Dis. 2020;75(1):84-92
3. **CKD-EPI 2021**: Ann Intern Med. 2021;174(2):183-191
4. **Cockcroft-Gault**: Nephron. 1976;16(1):31-41
5. **KDIGO AKI指南**: Kidney Int Suppl. 2012;2(1):1-138

## 📄 许可证

MIT License - 详见 LICENSE 文件