MCP Server Healthcare

Ein Model Context Protocol (MCP)-Server für einen klinischen Kodierungs-Workflow im NHS – Vorschlagen von ICD-10-CM/OPCS-4/HCC-Codes für eine klinische Notiz, Verfolgen von SAR/FOI-Information-Governance-Anfragen, Ausführen von DSAR-Mapping-Repository-Anfragen durch Klassifizierung und klinische Überprüfung, Batch-Kodierung und Lesen/Schreiben von Patientendaten über eine Cerner-FHIR-R4-Sandbox.

Jeder MCP-Client (Claude Desktop, Claude Code, Copilot Studios MCP-Connector usw.) kann diese Tools direkt aufrufen – keine REST-API-Schicht erforderlich.

Ursprünglich als Teil von bobbynoble/clinical-coding-bot erstellt; dieses Repo ist der eigenständige MCP-Server mit einer eigenen Kopie der Geschäftslogik, die er kapselt, sodass er keine Abhängigkeit von diesem Repo hat.

Werkzeuge

cerner_post_condition, cerner_post_procedure und cerner_writeback_episode führen echte Schreibvorgänge gegen die konfigurierte Cerner-Umgebung aus (standardmäßig eine Nicht-Produktions-Sandbox – siehe app/fhir_cerner.py).

Related MCP server: fhir-synthetic-mcp

Einrichtung

pip install -r requirements.txt
cp .env.example .env   # fill in Azure OpenAI / Search / Cerner credentials as needed

Jedes Tool wird unabhängig davon geladen, welche Anmeldeinformationen gesetzt sind, aber suggest_clinical_codes benötigt Azure OpenAI + Azure AI Search, und die cerner_*-Tools benötigen CERNER_CLIENT_ID/CERNER_CLIENT_SECRET – der Aufruf ohne die passenden Anmeldeinformationen schlägt mit einer klaren Fehlermeldung fehl, anstatt den Server zum Absturz zu bringen.

Ausführen

Stdio (Claude Desktop, Claude Code, die meisten lokalen MCP-Clients):

python -m MCP_Server_Healthcare

Beispiel für die Claude-Desktop-Konfiguration (claude_desktop_config.json):

{
  "mcpServers": {
    "clinical-coding-bot": {
      "command": "python",
      "args": ["-m", "MCP_Server_Healthcare"],
      "cwd": "/absolute/path/to/mcp_server_healthcare"
    }
  }
}

Streamable HTTP (Fernzugriff, z. B. von Copilot Studio oder einem gehosteten MCP-Client):

python -m MCP_Server_Healthcare --transport http --port 8010

Der HTTP-Transport erfordert, dass CODING_API_KEY in .env gesetzt ist – jede Anfrage muss einen passenden X-API-Key-Header enthalten, sonst wird sie mit 401 abgelehnt (Fail-Closed). Standardmäßig lauscht er auf 127.0.0.1; setzen Sie MCP_HOST=0.0.0.0 (und platzieren Sie ihn hinter TLS/einem Reverse-Proxy), um ihn über localhost hinaus verfügbar zu machen.

Repository-Struktur

MCP_Server_Healthcare/   the MCP server itself (server.py has the tool
                         definitions; __main__.py the stdio/http entry point;
                         auth.py the HTTP transport's API-key gate)
app/                     business logic each tool wraps — coder.py (RAG
                         coding), sar_foi.py, dsar.py, batch.py,
                         fhir_cerner.py. Each stores its state in a SQLite
                         file created alongside it on first run.

Hinweise

• Blockierende Netzwerkaufrufe (Azure OpenAI/Search, Cerner FHIR) werden mit asyncio.to_thread ausgelagert, sodass ein langsamer Aufruf andere Tool-Aufrufe auf demselben Server nicht blockiert.

• SQLite-Dateien (app/sar_foi.db, app/batch.db, app/dsar.db) werden beim ersten Start automatisch erstellt und sind gitignored.