Medcalcmcp

🚀 醫療計算器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                          # 項目文檔

🔧 開發指南

創建新的計算器

1. 在calculators/目錄下創建一個新的計算器文件
2. 繼承BaseCalculator類
3. 實現所需的方法：get_info()、validate_parameters()、calculate()
4. 使用@register_calculator裝飾器進行註冊
5. 在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

🔧 技術細節

🛠️ 技術架構

本項目採用模塊化設計，主要組件如下：

• MCP服務器 (server.py)：提供MCP協議接口
• 核心框架 (medcalc/)：數據模型、基類、實用工具
• 計算器引擎 (calculators/)：56個特定的醫療計算器
• 測試套件 (test/)：API測試和功能驗證

📋 項目狀態

• 當前版本：0.1.0
• 計算器數量：56個
• 測試覆蓋率：100%
• 支持的醫療領域：11個專業領域

🤝 貢獻說明

歡迎提交拉取請求和提出問題，以幫助改進項目。

🙏 致謝

本項目基於[MedCalc - Bench](https://github.com/ncbi - nlp/MedCalc - Bench)項目。感謝NCBI - NLP團隊提供了優秀的基礎醫療計算器實現。我們將其轉換為MCP（模型上下文協議）服務，以便更好地與現代AI應用集成。

原始項目參考：

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