Azure AHDS FHIR MCP-Server 🚀

Eine MCP-Serverimplementierung (Model Context Protocol) für Azure Health Data Services FHIR (Fast Healthcare Interoperability Resources). Dieser Dienst bietet eine standardisierte Schnittstelle für die Interaktion mit Azure FHIR-Servern und ermöglicht die Verarbeitung von Gesundheitsdaten über MCP-Tools.

Lizenz Python-Version MCP

Einrichtung 🛠️

Installation 📦

Erfordert Python 3.13 oder höher.

Installieren Sie das Paket mit pip :

pip install azure-fhir-mcp-server

MCP-Konfiguration ⚙️

Claude Desktop-Konfiguration

1 - Claude-Desktopkonfiguration bearbeiten:

Öffnen Sie claude_desktop_config.json und fügen Sie die folgende Konfiguration hinzu.

Unter MacOs befindet sich die Datei hier: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

Unter Windows befindet sich die Datei hier: %APPDATA%\Claude Desktop\claude_desktop_config.json .

{
    "mcpServers": {
        "fhir": {
            "command": "azure-fhir-mcp-server",
            "env": {
                "LOG_LEVEL": "INFO",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

Nachfolgend sehen Sie eine Tabelle mit den verfügbaren Umgebungskonfigurationsvariablen:

Variable	Beschreibung	Standard
`LOG_LEVEL`	Protokollierungsebene	`INFO`
`fhirUrl`	Azure FHIR-Server-URL	Erforderlich
`clientId`	OAuth2-Client-ID	Erforderlich
`clientSecret`	OAuth2-Clientgeheimnis	Erforderlich
`tenantId`	Azure AD-Mandanten-ID	Erforderlich

2 - Starten Sie Claude Desktop neu.

Verfügbare Tools 🔧

FHIR-Ressourcenbetrieb

search_fhir – Suche nach FHIR-Ressourcen basierend auf einem Wörterbuch mit Suchparametern

Ressourcenzugriff

Der Server bietet über das MCP-Ressourcenprotokoll Zugriff auf alle Standard-FHIR-Ressourcen:

fhir://Patient/ – Zugriff auf alle Patientenressourcen
fhir://Patient/{id} – Zugriff auf eine bestimmte Patientenressource
fhir://Observation/ - Zugriff auf alle Observation-Ressourcen
fhir://Observation/{id} – Zugriff auf eine bestimmte Beobachtungsressource
fhir://Medication/ - Zugriff auf alle Medikamentenressourcen
fhir://Medication/{id} – Zugriff auf eine bestimmte Medikamentenressource
Und viele mehr...

Related MCP server: HAPI-MCP

Entwicklung 💻

Lokales Entwicklungs-Setup

1 - Klonen Sie das Repository:

git clone https://github.com/erikhoward/azure-fhir-mcp-server.git
cd azure-fhir-mcp-server

2 - Virtuelle Umgebung erstellen und aktivieren:

Linux/macOS:

python -m venv .venv
source .venv/bin/activate

Windows:

python -m venv .venv
.venv\Scripts\activate

3 – Abhängigkeiten installieren:

pip install -e ".[dev]"

4 – Umgebungsvariablen kopieren und konfigurieren:

cp .env.example .env

Bearbeiten Sie .env mit Ihren Einstellungen:

fhirUrl=https://your-fhir-server.azurehealthcareapis.com/fhir
clientId=your-client-id
clientSecret=your-client-secret
tenantId=your-tenant-id

5 - Claude Desktop-Konfiguration

Öffnen Sie claude_desktop_config.json und fügen Sie die folgende Konfiguration hinzu.

Unter MacOs befindet sich die Datei hier: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

Unter Windows befindet sich die Datei hier: %APPDATA%\Claude Desktop\claude_desktop_config.json .

{
    "mcpServers": {
        "fhir": {
            "command": "python",
            "args": [
                "-m",
                "fhir_mcp_server.server"
            ],
            "cwd": "/path/to/azure-fhir-mcp-server/repo",
            "env": {
                "LOG_LEVEL": "DEBUG",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

6 – Starten Sie Claude Desktop neu.