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.

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:

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: Smart EHR MCP Server

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.

Beiträge 🤝

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/AmazingFeature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m '✨ Add some AmazingFeature' )

4. Pushen zum Zweig ( git push origin feature/AmazingFeature )

5. Öffnen einer Pull-Anfrage

Lizenz ⚖️

Lizenziert unter MIT – siehe Datei LICENSE.md .

Dies ist kein offizielles Microsoft- oder Azure-Produkt.