Servidor MCP FHIR de Azure AHDS 🚀

Implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para Azure Health Data Services FHIR (Recursos de Interoperabilidad Rápida para la Atención Médica). Este servicio proporciona una interfaz estandarizada para interactuar con servidores de Azure FHIR, lo que permite la gestión de datos de atención médica mediante herramientas MCP.

Configuración 🛠️

Instalación 📦

Requiere Python 3.13 o superior.

Instale el paquete usando pip :

pip install azure-fhir-mcp-server

Configuración de MCP ⚙️

Configuración del escritorio de Claude

1 - Editar la configuración del escritorio de Claude:

Abra claude_desktop_config.json y agregue la siguiente configuración.

En MacOs, el archivo se encuentra aquí: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

En Windows, el archivo se encuentra aquí: %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"
            }
        }
    }
}

La siguiente es una tabla de variables de configuración de entorno disponibles:

2 - Reinicie Claude Desktop.

Herramientas disponibles 🔧

Operaciones de recursos de FHIR

• search_fhir : búsqueda de recursos FHIR basándose en un diccionario de parámetros de búsqueda

Acceso a recursos

El servidor proporciona acceso a todos los recursos FHIR estándar a través del protocolo de recursos MCP:

• fhir://Patient/ - Acceso a todos los recursos para pacientes

• fhir://Patient/{id} - Acceder a un recurso específico del Paciente

• fhir://Observation/ - Acceda a todos los recursos de Observación

• fhir://Observation/{id} - Acceder a un recurso de observación específico

• fhir://Medication/ - Acceda a todos los recursos sobre medicamentos

• fhir://Medication/{id} - Acceda a un recurso de medicación específico

• Y muchos más...

Related MCP server: Smart EHR MCP Server

Desarrollo 💻

Configuración de desarrollo local

1 - Clonar el repositorio:

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

2 - Crear y activar entorno virtual:

Linux/macOS:

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

Ventanas:

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

3 - Instalar dependencias:

pip install -e ".[dev]"

4 - Copiar y configurar variables de entorno:

cp .env.example .env

Edite .env con su configuración:

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

5 - Configuración del escritorio de Claude

Abra claude_desktop_config.json y agregue la siguiente configuración.

En MacOs, el archivo se encuentra aquí: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

En Windows, el archivo se encuentra aquí: %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 - Reinicie Claude Desktop.

Contribuciones 🤝

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/AmazingFeature )

3. Confirme sus cambios ( git commit -m '✨ Add some AmazingFeature' )

4. Empujar a la rama ( git push origin feature/AmazingFeature )

5. Abrir una solicitud de extracción

Licencia ⚖️

Con licencia MIT - consulte el archivo LICENSE.md .

Este no es un producto oficial de Microsoft o Azure.