Medical Calculator

Medical Calculator MCP Service Implementation

python

9

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "winninghealth-medcalcmcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You can run a comprehensive Medical Calculator MCP Server that exposes 56 medical calculators across multiple clinical domains. This server lets you query a wide range of validated calculations, unit conversions, and explanations through a standardized MCP interface, enabling easy integration with AI assistants and clinical tools.

How to use

You connect to the server using an MCP client to request calculations by name and supply the required input parameters. The server processes requests asynchronously when needed and returns results with explanations to support clinical decision making. You can perform common workflows such as calculating body metrics, assessing cardiovascular risk, estimating renal or hepatic function, interpreting laboratory values, and applying critical care scores. Use the appropriate calculator name and provide input parameters in the expected units. If a parameter is optional, you can omit it or provide a default value as supported by the calculator.

How to install

Prerequisites: ensure Python is installed on your system and you have network access if you choose to run the HTTP variant. You will also need a compatible MCP client to communicate with the server.

Step 1: Install dependencies

pip install -r requirements.txt

Step 2: Start the MCP server

python server.py

Step 3: Optional API server (if you prefer an MCP API gateway)

python api_server.py

Configuration and security notes

The server runs in a standard Python environment and relies on the provided codebase for calculator registrations and parameter validation. For production deployments, consider securing HTTP endpoints, enabling authentication for MCP clients, and configuring appropriate logging and monitoring. If you operate both the FastMCP and API gateways, you can choose the deployment that best fits your infrastructure and latency requirements.

Tools and capabilities overview

The MCP Server exposes a broad set of calculators across several medical domains. Examples include BMI and BSA calculations for anthropometry, CHA2DS2-VASc and HAS-BLED risk scores for cardiovascular risk, Creatinine Clearance for renal function, and Lung Cancer TNM staging for oncology. Each calculator validates input, performs unit conversions when needed, and provides explanatory results to support clinical interpretation.

Examples and usage notes

Examples of common workflows include calculating a patient’s BMI from height and weight, estimating BSA for dosing or surface-area dependent calculations, assessing stroke risk using CHA2DS2-VASc, or staging lung cancer with the TNM calculator. For each calculator, supply the required input parameters in the expected units, and review the accompanying explanation to understand the clinical interpretation.

Available tools

BMI Calculator

Calculates Body Mass Index from weight and height with input validation and unit handling.

BSA Calculator

Calculates Body Surface Area using standard anthropometric formulas and supports unit conversions.

Creatinine Clearance Calculator

Estimates creatinine clearance using the Cockcroft-Gault method with optional body surface area adjustment.

CHA2DS2-VASc Score

Assesses stroke risk in patients with atrial fibrillation using the CHA2DS2-VASc scoring system.

Lung Cancer TNM Staging Calculator

Determines TNM stage for lung cancer based on tumor size, nodal involvement, and metastasis.