MCP FHIR Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Connects to SMART on FHIR servers, enabling access to healthcare data with proper authentication via access tokens.

@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:

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor MCP basado en TypeScript que se conecta a servidores FHIR, lo que permite el acceso a datos de atención médica a través de URI fhir:// y proporciona capacidades de búsqueda para recursos FHIR.

  1. Features
    1. Resources
    2. Tools
  2. Configuration
    1. Development
      1. Installation
        1. Debugging
      ID: aske4zko9f