Servidor MCP FHIR de Azure AHDS 🚀

Name: Azure AHDS FHIR MCP Server
Author: erikhoward

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.

Licencia Versión de Python 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:

Variable	Descripción	Por defecto
`LOG_LEVEL`	Nivel de registro	`INFO`
`fhirUrl`	URL del servidor FHIR de Azure	Requerido
`clientId`	ID de cliente de OAuth2	Requerido
`clientSecret`	Secreto de cliente OAuth2	Requerido
`tenantId`	Identificador de inquilino de Azure AD	Requerido

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: HAPI-MCP

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.