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