MCP FHIR Server

@flexpa/mcp-fhir

[!ADVERTENCIA] Esta es una demostración experimental, no destinada para uso en producción.

Este es un servidor MCP basado en TypeScript que se conecta a un servidor FHIR. Proporciona la funcionalidad básica de MCP para interactuar con los recursos FHIR mediante:

• Acceso a recursos FHIR a través de URI
• Proporcionar capacidades de búsqueda para recursos FHIR

Características

Recursos

[!TIP] "Recursos" se refiere a la definición de MCP, no a la de FHIR. Los recursos de MCP son una primitiva fundamental del Protocolo de Contexto de Modelo (MCP) que permite a los servidores exponer datos y contenido que los clientes pueden leer y utilizar como contexto para las interacciones LLM.

• Enumere y acceda a los recursos de FHIR mediante las URI fhir://
• Los recursos se devuelven en formato FHIR JSON
• Admite todos los tipos de recursos FHIR disponibles en la declaración de capacidad del servidor FHIR

Herramientas

• search_fhir - Buscar recursos FHIR
  • Toma resourceType y searchParams como parámetros
  • Devuelve resultados de búsqueda FHIR
• read_fhir : lee un recurso FHIR individual
  • Toma uri como parámetro
  • Devuelve el recurso FHIR en formato JSON

Configuración

El servidor requiere las siguientes variables de entorno:

• FHIR_BASE_URL : La URL base de su servidor FHIR
• FHIR_ACCESS_TOKEN : Un token de acceso SMART en FHIR para autenticación

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.