Servidor MCP de FHIR para el cuidado de la salud

Servidor MCP de FHIR R4 (Fast Healthcare Interoperability Resources) para aplicaciones de IA en el cuidado de la salud. Busque pacientes, condiciones, medicamentos, observaciones y planes de cuidado desde cualquier servidor compatible con FHIR R4, con validación de seguridad basada en el cuidado para datos clínicos generados por IA.

Creado por MEOK AI Labs, el equipo detrás de MEOK AI OS y el marco de trabajo de membrana de cuidado Sovereign Temple.

Por qué existe esto

La IA en el cuidado de la salud necesita acceso estructurado a datos clínicos, pero las herramientas existentes carecen de barreras de seguridad para el contenido generado por IA. Este servidor valida las observaciones creadas por IA frente a rangos de seguridad fisiológica antes de que lleguen al registro de salud. Inspirado en el marco de membrana de cuidado de MEOK, evita que la IA registre signos vitales imposibles, como una frecuencia cardíaca de 500 lpm o una temperatura corporal de 90 grados Celsius.

Herramientas

Instalación

pip install mcp requests

Configuración

Establezca la variable de entorno FHIR_SERVER_URL en el punto de conexión de su servidor FHIR R4.

Servidores de prueba públicos

Para desarrollo y pruebas, puede utilizar estos servidores FHIR R4 públicos:

• HAPI FHIR: https://hapi.fhir.org/baseR4

• SMART Health IT: https://r4.smarthealthit.org

Uso

Ejecutar el servidor

FHIR_SERVER_URL=https://hapi.fhir.org/baseR4 python server.py

Configuración de Claude Desktop

Añadir a ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "healthcare-fhir": {
      "command": "python",
      "args": ["/path/to/healthcare-fhir-mcp/server.py"],
      "env": {
        "FHIR_SERVER_URL": "https://hapi.fhir.org/baseR4"
      }
    }
  }
}

Llamadas de ejemplo

Buscar pacientes:

Tool: search_patients
Input: {"name": "Smith", "count": 5}
Output: {"total": 142, "patients": [{"id": "123", "name": "John Smith", "birthDate": "1980-03-15", ...}]}

Obtener condiciones:

Tool: search_conditions
Input: {"patient_id": "123", "clinical_status": "active"}
Output: {"total": 3, "conditions": [{"display": "Type 2 diabetes", "code": "44054006", ...}]}

Crear observación con validación de seguridad:

Tool: create_observation
Input: {"patient_id": "123", "loinc_code": "8867-4", "display_name": "Heart rate", "value": 72, "unit": "bpm"}
Output: {"created": true, "id": "456", "validation": {"valid": true, "safety_check": "passed"}}

Observación insegura rechazada:

Tool: create_observation
Input: {"patient_id": "123", "loinc_code": "8867-4", "display_name": "Heart rate", "value": 500, "unit": "bpm"}
Output: {"created": false, "validation": {"valid": false, "errors": ["SAFETY: Heart rate value 500 is outside safe range (30-220 bpm)"]}}

Validación de seguridad basada en el cuidado

La membrana de cuidado valida las observaciones clínicas generadas por IA frente a rangos fisiológicos conocidos:

Los valores fuera de estos rangos se rechazan con un error descriptivo. Las observaciones generadas por IA también se marcan si utilizan el estado final (que debería reservarse para datos verificados por el médico).

Consideraciones de seguridad

• Manejo de PHI: Este servidor se conecta a servidores FHIR que pueden contener Información de Salud Protegida (PHI). Asegúrese de que su implementación cumpla con HIPAA, GDPR o las regulaciones aplicables.

• Autenticación: Utilice FHIR_AUTH_TOKEN para servidores FHIR de producción. Nunca utilice servidores de prueba públicos con datos reales de pacientes.

• Seguridad de transporte: Utilice siempre HTTPS para las URL de los servidores FHIR en producción.

• Datos generados por IA: Todas las observaciones creadas a través de create_observation se validan frente a rangos de seguridad y tienen como valor predeterminado el estado preliminary. La IA nunca debe establecer el estado final en datos clínicos.

• Auditoría: Considere habilitar el registro de auditoría de su servidor FHIR (recurso AuditEvent) para el cumplimiento.

• Control de acceso: El servidor MCP hereda los permisos del token de autenticación FHIR. Utilice el principio de menor privilegio.

• Limitación de tasa: La limitación de tasa integrada evita el abuso. El nivel gratuito permite 100 llamadas/día; el nivel Pro permite 10,000 llamadas/día.

Recursos FHIR R4 compatibles

• Patient

• Condition

• MedicationRequest

• Observation

• CarePlan

Se pueden consultar tipos de recursos adicionales a través de la herramienta validate_resource para la validación estructural.

Precios

El nivel Enterprise incluye un Acuerdo de Asociado Comercial (BAA) para entidades cubiertas por HIPAA.

Licencia

MIT