Medcalcmcp

医疗计算器MCP服务，包含56个专业医疗计算器，覆盖11个医学专科领域，支持智能单位转换和详细医学解释。

健康与养生研究与数据 #医疗计算 #医学工具 #临床辅助 #MCP服务 .Python

评分 : 2.5分

下载量 : 5.4K

更新时间 : 2025-12-12

打开站点

什么是Medical Calculator MCP Service?

这是一个基于Model Context Protocol (MCP)的医学计算器服务，专门为医疗专业人员、研究人员和AI助手提供专业、准确的医学计算功能。服务集成了56个经过验证的医学计算器，能够处理从基础的身体质量指数(BMI)到复杂的危重症评分等各种医学计算需求。

如何使用Medical Calculator MCP Service?

您可以通过MCP协议连接到该服务，然后使用简单的API调用来执行各种医学计算。无论是通过AI助手、医疗应用程序还是直接编程调用，都可以轻松访问这些专业计算功能。服务支持自动单位转换和详细的医学解释。

适用场景

该服务适用于： 1. 临床医生快速计算患者评分和指标 2. 医疗AI助手提供准确的医学计算支持 3. 医疗应用程序集成专业计算功能 4. 医学教育和培训中的计算演示 5. 临床研究和数据分析中的标准化计算

主要功能

全面的计算器集合

提供56个专业医学计算器，覆盖11个医学专业领域，包括心血管、肾脏、肝脏、呼吸系统等关键临床领域。

智能单位转换

自动处理各种医学单位的转换，如身高（cm/in）、体重（kg/lb）、实验室值等，确保计算准确性。

详细医学解释

每个计算结果都附带专业的医学解释和临床意义说明，帮助用户理解计算结果的临床含义。

标准MCP协议支持

采用标准的Model Context Protocol，可以轻松集成到各种AI助手和应用程序中。

完整的参数验证

对所有输入参数进行严格的医学合理性验证，确保计算的安全性和准确性。

高性能异步处理

支持异步计算处理，能够快速响应多个并发请求，适合高负载的临床环境。

优势

专业准确性：所有计算器基于医学标准和临床指南

全面覆盖：56个计算器满足大多数临床计算需求

易于集成：标准MCP协议简化了与AI系统的集成

详细解释：提供临床意义的解释而不仅仅是数字结果

开源基础：基于NCBI-NLP的MedCalc-Bench项目，有学术支持

局限性

需要技术集成：非技术人员需要技术支持才能使用

不替代临床判断：计算结果仅供参考，不能替代专业医疗建议

特定领域：主要针对成人医学计算，儿科计算器相对较少

网络依赖：作为服务需要网络连接（除非本地部署）

更新延迟：医学指南更新时，计算器可能需要相应更新

如何使用

安装依赖

首先确保系统已安装Python，然后安装项目所需的所有依赖包。

启动服务器

启动MCP服务器，服务将在指定端口运行，准备接收计算请求。

连接到服务

通过MCP客户端或API连接到运行中的服务器。

调用计算器

发送计算请求，包含必要的参数，如身高、体重、实验室值等。

获取结果

接收包含计算结果和医学解释的响应。

使用案例

临床医生快速评估患者

医生在查房时需要快速计算多位患者的BMI和心血管风险评分。通过AI助手连接到MCP服务，可以快速获取准确的计算结果。

医疗AI助手集成

医疗AI助手需要为用户的健康咨询提供专业的医学计算支持。集成MCP服务后，AI可以准确回答各种医学计算问题。

医疗应用程序开发

开发医疗记录应用程序，需要集成专业的医学计算功能。通过MCP服务API，可以轻松添加各种计算器而无需自行开发。

医学教育培训

医学院教师使用MCP服务演示各种医学计算，帮助学生理解临床评分系统的应用。

常见问题

这个服务可以替代医生的专业判断吗？

需要什么样的技术知识才能使用这个服务？

服务支持哪些计算器？

计算结果的准确性如何保证？

可以在没有网络的环境中使用吗？

如何添加新的计算器？

服务处理医疗数据的隐私性如何？

支持儿科计算吗？

🚀 医疗计算器MCP服务

本项目实现了医疗计算器MCP服务，完成了56个医疗计算器，覆盖了多个医疗领域，包括人体测量学、心血管、肾功能、肝功能、实验室检测、重症监护评分、呼吸系统、感染与炎症、液体与药物、妇产科和肿瘤学等。

🚀 快速开始

安装依赖

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

✨ 主要特性

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

📦 安装指南

安装依赖

pip install -r requirements.txt

💻 使用示例

启动服务器

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

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

📚 详细文档

🏥 计算器分类

人体测量学和基础计算（5个）

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

心血管系统（11个）

平均动脉压计算器
QTc间期计算器（5种公式）
CHA2DS2 - VASc中风风险评分
HAS - BLED出血风险评分
HEART评分计算器
心脏风险指数计算器
弗雷明汉风险评分
韦尔斯深静脉血栓评分
卡普里尼血栓形成风险评估

肾功能（4个）

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

肝功能（3个）

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

实验室检测（12个）

阴离子间隙计算器及相关计算器
钙校正计算器
高血糖时钠校正
血清渗透压计算器
低密度脂蛋白胆固醇计算器
HOMA - IR胰岛素抵抗指数
自由水缺乏计算器

重症监护和评分系统（8个）

APACHE II急性生理学评分
SOFA序贯器官衰竭评估
SIRS全身炎症反应综合征
格拉斯哥昏迷评分
格拉斯哥出血评分
查尔森合并症指数

呼吸系统（4个）

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

感染与炎症（2个）

森托尔链球菌性咽炎评分
FeverPAIN咽炎评分

液体与药物（3个）

维持液计算器
类固醇转换计算器
吗啡毫克当量计算器

妇产科（3个）

估计受孕日期计算器
估计孕周计算器
估计预产期计算器

肿瘤学（1个）

肺癌TNM分期计算器

📁 项目结构

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                          # 项目文档

🔧 开发指南

创建新的计算器

在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