医

医学计算器 MCP 服务

wair/medcalcmcp

3 Stars 564 次浏览更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "MedCalc": {
      "type": "streamable-http",
      "url": ""
    }
  }
}

服务介绍

Medical Calculator MCP Service

中文版 | English

医学计算器 MCP 服务实现。

🚀 项目概述

这是一个医学计算器 MCP 服务实现，目前已完成 56个医学计算器 的开发，涵盖人体测量学、心血管、肾脏功能、肝脏功能、实验室检验、危重症评分、呼吸系统、感染炎症、液体药物、妊娠相关、肿瘤学等多个医学领域。

🏥 计算器分类

人体测量学和基础计算 (5个)

BMI计算器 - 体重指数计算
体表面积计算器 - BSA计算
理想体重计算器 - IBW计算
调整体重计算器 - ABW计算
目标体重计算器

心血管系统 (11个)

平均动脉压计算器
QTc间期计算器（5种公式）
CHA2DS2-VASc卒中风险评分
HAS-BLED出血风险评分
HEART评分计算器
心脏风险指数计算器
Framingham风险评分
Wells深静脉血栓评分
Caprini血栓风险评估

肾脏功能 (4个)

肌酐清除率计算器（Cockcroft-Gault）
CKD-EPI肾小球滤过率计算器
MDRD肾小球滤过率计算器
钠排泄分数计算器

肝脏功能 (3个)

Child-Pugh肝功能分级
MELD-Na评分计算器
FIB-4肝纤维化指数

实验室检验 (12个)

阴离子间隙计算器及相关计算器
钙离子校正计算器
高血糖钠离子校正
血清渗透压计算器
LDL胆固醇计算器
HOMA-IR胰岛素抵抗指数
自由水缺失计算器

危重症和评分系统 (8个)

APACHE II急性生理评分
SOFA序贯器官衰竭评估
SIRS全身炎症反应综合征
Glasgow昏迷评分
Glasgow出血评分
Charlson合并症指数

呼吸系统 (4个)

CURB-65肺炎严重程度评分
肺炎严重程度指数（PSI）
Wells肺栓塞评分
PERC肺栓塞排除标准

感染和炎症 (2个)

Centor链球菌性咽炎评分
FeverPAIN咽炎评分

液体和药物 (3个)

维持液体计算器
激素转换计算器
吗啡当量剂量计算器

妊娠相关 (3个)

预计受孕日期计算器
预计妊娠期计算器
预计分娩日期计算器

肿瘤学 (1个)

肺癌TNM分期计算器

📚 快速开始

安装依赖：
```
pip install -r requirements.txt
```

运行测试：

# 运行所有API测试
python test/api_test_bmi_calculator.py
python test/api_test_pregnancy_calculators.py
python test/api_test_lung_cancer_staging.py
python test/api_test_tools.py

# 运行基础测试
python test_bmi.py

启动服务器：
```
python server.py
```

📁 项目结构

medcalcmcp/
├── medcalc/                           # 核心框架模块
│   ├── __init__.py                   # 模块导出
│   ├── models.py                     # 数据模型
│   ├── base.py                       # 基础计算器类
│   ├── registry.py                   # 计算器注册系统
│   ├── service.py                    # 计算器服务
│   ├── utils.py                      # 工具类（单位转换等）
│   └── exceptions.py                 # 异常定义
├── calculators/                       # 计算器实现（56个计算器）
│   ├── __init__.py                   # 计算器包（统一管理所有计算器）
│   ├── bmi_calculator.py             # BMI 计算器
│   ├── bsa_calculator.py             # 体表面积计算器
│   ├── creatinine_clearance_calculator.py  # 肌酐清除率计算器
│   ├── cha2ds2_vasc_calculator.py    # CHA2DS2-VASc评分
│   ├── lung_cancer_staging_calculator.py  # 肺癌TNM分期计算器
│   └── ...                          # 其他53个计算器
├── test/                              # 测试文件目录
│   ├── api_test_bmi_calculator.py    # BMI 计算器 API 测试
│   ├── api_test_pregnancy_calculators.py  # 妊娠相关计算器 API 测试
│   ├── api_test_lung_cancer_staging.py    # 肺癌分期计算器 API 测试
│   └── api_test_tools.py             # MCP 工具动态测试
├── server.py                          # FastMCP 服务器主文件
├── api_server.py                      # MCP API 服务器
├── requirements.txt                   # 项目依赖
└── README.md                          # 项目文档

🛠️ 技术架构

项目采用模块化设计，主要组成部分：

MCP 服务器 (server.py): 提供 MCP 协议接口
核心框架 (medcalc/): 数据模型、基础类、工具类
计算引擎 (calculators/): 56个具体的医学计算器
测试套件 (test/): API 测试和功能验证

✨ 主要特性

✅ 完整的医学计算器集合: 56个专业医学计算器
✅ 多领域覆盖: 涵盖临床医学各个专业领域
✅ 智能单位转换: 支持各种医学单位的自动转换
✅ 详细的计算解释: 每个结果都包含详细的医学解释
✅ 完整的参数验证: 确保输入数据的准确性和安全性
✅ MCP 协议支持: 标准化的接口协议
✅ 异步处理: 高性能的异步计算处理
✅ 完整的测试覆盖: 全面的API和功能测试

🚀 启动服务器

# 启动 FastMCP 服务器（推荐）
python server.py

# 或启动 MCP API 服务器
python api_server.py
# 服务器将在 http://127.0.0.1:8010/mcp/ 运行

🔧 开发指南

创建新计算器

在 calculators/ 目录下创建新的计算器文件
继承 BaseCalculator 类
实现必需的方法：get_info(), validate_parameters(), calculate()
使用 @register_calculator 装饰器注册
在 calculators/__init__.py 中添加导入

运行测试

# 测试特定计算器
python test/api_test_bmi_calculator.py

# 测试所有计算器（动态测试）
python test/api_test_tools.py

# 测试妊娠相关计算器
python test/api_test_pregnancy_calculators.py

# 测试肺癌分期计算器
python test/api_test_lung_cancer_staging.py

📋 项目状态

当前版本: 0.1.0
计算器数量: 56个
测试覆盖率: 100%
支持的医学领域: 11个专业领域

🤝 贡献

欢迎提交 Pull Request 或创建 Issue 来帮助改进项目。

🙏 致谢

本项目基于 MedCalc-Bench 项目开发，感谢 NCBI-NLP 团队提供的优秀医学计算器基础实现。我们将其转换为 MCP (Model Context Protocol) 服务，使其能够更好地集成到现代AI应用中。

原始项目引用:

GitHub: https://github.com/ncbi-nlp/MedCalc-Bench
论文: MedCalc-Bench: A Large-scale Medical Calculator Benchmark

查看源码项目主页