mcp-clinical-tools

An MCP (Model Context Protocol) server exposing AI tools for clinical software development. Built specifically for medical device software teams working with FHIR interoperability standards and IEC 62304 compliance requirements.

---

What It Does

This server exposes 3 clinical AI tools via the Model Context Protocol:

Tool	Description
fhir_resource_generator	Generates sample FHIR R4 resources — Patient, Observation, Device, DeviceMetric
medical_abbreviation_lookup	Resolves clinical abbreviations — SpO2, MAP, GCS, PEEP, EtCO2, MDR, and more
iec62304_checklist	Generates an IEC 62304 verification checklist for a given function and safety class

Once connected to Claude Desktop:

• "Generate a FHIR Observation resource for patient-042"
• "What does EtCO2 mean?"
• "Give me a Class C IEC 62304 checklist for set_ventilation_pressure_limit"

---

Why This Exists

Developers working on medical device software face two constant challenges:

1. Clinical domain gap — software engineers who are not clinicians frequently encounter abbreviations and data structures (FHIR resources, vital sign codes) that slow them down.
2. Compliance overhead — IEC 62304 verification requires structured documentation for every software unit. Generating that manually is slow and inconsistent.

These tools remove both friction points — letting developers stay in their workflow while getting instant access to clinical context and compliance scaffolding.

---

Architecture

┌─────────────────────┐     JSON-RPC / stdio     ┌───────────────────────────────┐
│   Claude Desktop    │ ◄─────────────────────── │   mcp-clinical-tools server   │
│   (MCP Client)      │                          │   (Python / FastMCP)          │
└─────────────────────┘                          │                               │
                                                 │  * fhir_resource_generator    │
         OR                                      │  * medical_abbreviation_lookup│
                                                 │  * iec62304_checklist         │
┌─────────────────────┐                          └───────────────────────────────┘
│  Your Python Client │ ◄── stdio_client() ──────────────────┘
└─────────────────────┘

---

Getting Started

1. Install

git clone https://github.com/SKeval/mcp-clinical-tools
cd mcp-clinical-tools
pip install -r requirements.txt

2. Test

python client.py

3. Connect to Claude Desktop

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-clinical-tools": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-clinical-tools/server.py"]
    }
  }
}

---

Tool Reference

fhir_resource_generator

Generates FHIR R4 resources for development and testing.

Parameter	Type	Options
resource_type	str	Patient, Observation, Device, DeviceMetric
patient_id	str	any string, default "patient-001"
include_narrative	bool	default True

---

medical_abbreviation_lookup

Resolves clinical abbreviations with full context and normal ranges.

Covers: SpO2, MAP, HR, RR, BP, EtCO2, FiO2, PEEP, GCS, ICP, ABG, ECG, NIV, CPAP, BiPAP, ICU, IEC, MDR, SaMD, QMS, and more.

---

iec62304_checklist

Generates verification checklists based on IEC 62304 safety class.

Safety Class	Risk Level	Example Function
A	No injury possible	UI display function
B	Non-serious injury possible	Alarm threshold setter
C	Death or serious injury possible	Drug dosage calculator

---

License

MIT License