Serveur MCP Azure AHDS FHIR 🚀

Mise en œuvre d'un serveur de protocole de contexte de modèle (MCP) pour les services de données de santé Azure FHIR (ressources d'interopérabilité rapide pour les soins de santé). Ce service fournit une interface standardisée pour interagir avec les serveurs Azure FHIR, permettant des opérations sur les données de santé par le biais d'outils MCP.

Installation 🛠️

Installation 📦

Nécessite Python 3.13 ou plus et uv.

Installer uv en premier.

Configuration MCP ⚙️

Configuration du bureau de Claude

1 - Editer la configuration du bureau Claude :

Ouvrez claude_desktop_config.json et ajoutez la configuration suivante.

Sur MacOs, le fichier est situé ici : ~/Bibliothèque/Application Support/Claude Desktop/claude_desktop_config.json.

Sous Windows, le fichier est situé ici : %APPDATA%\Claude Desktop\claude_desktop_config.json.

{ "mcpServers" : {"fhir" : {"command" : "uvx", "args" : [ "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" } } } }

Voici un tableau des variables de configuration de l'environnement disponibles :

2 - Redémarrer Claude Desktop.

Outils disponibles 🔧

Opérations sur les ressources FHIR

• search_fhir - Recherche de ressources FHIR sur la base d'un dictionnaire de paramètres de recherche

Accès aux ressources

Le serveur fournit un accès à toutes les ressources FHIR standard par le biais du protocole de ressources MCP :

• fhir://Patient/ - Accès à toutes les ressources du patient
• fhir://Patient/{id} - Accès à une ressource patient spécifique
• fhir://Observation/ - Accès à toutes les ressources d'observation
• fhir://Observation/{id} - Accéder à une ressource d'observation spécifique
• fhir://Medication/ - Accède à toutes les ressources Médicaments
• fhir://Medication/{id} - Accéder à une ressource Médication spécifique
• Et bien d'autres encore...

Développement 💻

Configuration du développement local

1 - Cloner le dépôt :

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

2 - Créer et activer l'environnement virtuel :

Linux/macOS :

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

Windows :

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

3 - Installer les dépendances :

pip install -e ".[dev]"

4 - Copier et configurer les variables d'environnement :

cp .env.example .env

Editez .env avec vos paramètres :

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

5 - Configuration du bureau de Claude

Ouvrez claude_desktop_config.json et ajoutez la configuration suivante.

Sur MacOs, le fichier est situé ici : ~/Bibliothèque/Application Support/Claude Desktop/claude_desktop_config.json.

Sous Windows, le fichier est situé ici : %APPDATA%\Claude Desktop\claude_desktop_config.json.

{ "mcpServers" : {"fhir" : {"command" : "uv", "args" : [ "--directory", "/path/to/azure-fhir-mcp-server/repo", "run", "azure_fhir_mcp_server" ], "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 - Redémarrer Claude Desktop.

Contributions 🤝

Les contributions sont les bienvenues ! N'hésitez pas à soumettre une Pull Request.

1. Créer un dépôt (Fork)
2. Créez votre branche(git checkout -b feature/AmazingFeature)
3. Commencez vos modifications(git commit -m '✨ Add some AmazingFeature')
4. Pousser vers la branche(git push origin feature/AmazingFeature)
5. Ouvrir une Pull Request

Licence ⚖️

Sous licence MIT - voir le fichier LICENSE.md.

Il ne s'agit pas d'un produit officiel de Microsoft ou d'Azure.