Azure AHDS FHIR MCP-Server

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:

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...

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.

Forken Sie das Repository
Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/AmazingFeature )
Übernehmen Sie Ihre Änderungen ( git commit -m '✨ Add some AmazingFeature' )
Pushen zum Zweig ( git push origin feature/AmazingFeature )
Öffnen einer Pull-Anfrage

Lizenz ⚖️

Lizenziert unter MIT – siehe Datei LICENSE.md .

Dies ist kein offizielles Microsoft- oder Azure-Produkt.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

search_fhir

Ein Model Context Protocol-Server, der eine standardisierte Interaktion mit Azure Health Data Services FHIR-Servern ermöglicht und so Operationen mit Gesundheitsdaten über MCP-Tools zulässt.

Related MCP Servers

Smart EHR MCP Server
jmandel
-
security
A
license
-
quality
A Model Context Protocol server that connects AI tools to Electronic Health Records using SMART on FHIR, allowing secure searching, querying, and analysis of patient data from compatible EHRs.
Last updated -
63
MIT License
HAPI-MCP
ericmc21
-
security
F
license
-
quality
A Model Context Protocol server that enables querying FHIR healthcare data using natural language, allowing doctors to retrieve patient information, medications, observations, and other healthcare records.
Last updated -
1
Medplum MCP Server
rkirkendall
A
security
A
license
A
quality
A Model Context Protocol server that enables natural language commands to manage healthcare data stored in Medplum FHIR servers through standardized Create, Read, Update, and Search operations.
Last updated -
37
11
MIT License
FHIR Careplan
Kushagra-Dutta
-
security
F
license
-
quality
A comprehensive Model Context Protocol server that provides universal access to multiple FHIR servers with AI-powered clinical analysis capabilities for healthcare data integration and patient care planning.
Last updated -
1

View all related MCP servers

Azure AHDS FHIR MCP Server