@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

Related MCP server: Myrcael

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:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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

{
  "mcpServers": {
    "fhir": {
      "command": "/path/to/@flexpa/mcp-fhir/build/index.js"
    },
    "env": {
      "FHIR_BASE_URL": "<FHIR_BASE_URL>",
      "FHIR_ACCESS_TOKEN": "<FHIR_ACCESS_TOKEN>"
    }
  }
}

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:

npm run inspector

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