FHIR MCP Server

Name: FHIR MCP Server
Author: wso2

de wso2versión 0.11.0i★ 137iSe ejecuta en tu computadora

Nombre en el registroio.github.wso2/fhir-mcp-server

Instalar

Resumen

Descripción del creador (original en inglés)

MCP server providing seamless access to FHIR APIs for AI tools and healthcare applications

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi3 de 3 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiEn crecimiento↓ 823/sem · ★ 137

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Clínicas y salud
Debes completar: FHIR_SERVER_BASE_URL

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 3 de 3 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: FHIR_SERVER_BASE_URL

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "fhir": {
      "command": "uvx",
      "args": [
        "fhir-mcp-server"
      ],
      "env": {
        "FHIR_SERVER_BASE_URL": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add fhir --env FHIR_SERVER_BASE_URL=your-value -- uvx fhir-mcp-server

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "fhir": {
      "command": "uvx",
      "args": [
        "fhir-mcp-server"
      ],
      "env": {
        "FHIR_SERVER_BASE_URL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "fhir": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fhir-mcp-server"
      ],
      "env": {
        "FHIR_SERVER_BASE_URL": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

FHIR_SERVER_BASE_URL obligatorio env
Base URL of the FHIR Server (eg: https://hapi.fhir.org/baseR5)

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 9 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub wso2, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 6 días
✓ Superada
Tiene licencia
Usa Apache-2.0
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Clínicas y saludi

Más estrellas que el 100% de los otros 1031 servidores de esta categoría
Publicado en el registro más recientemente que el 69% de los otros 1031 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1031 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro FHIR MCP Server?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: FHIR_SERVER_BASE_URL

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.11.0) llegó al registro hace 10 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Mirobody, Google Health MCP, Langcare MCP FHIR

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Mirobody

Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.

de thetahealthEn crecimiento↓ 290/sem★ 1,4 milActualizado ayer

Se ejecuta en tu computadora✓ thetahealth.ai

Instalar

Google Health MCP

Privacy-first unofficial Google Health API v4 MCP server for health, sleep, activity, HR agents

de davidmosiahEn crecimiento↓ 1 mil/sem★ 79Actualizado hace 4 meses

Se ejecuta en tu computadora

Instalar

Langcare MCP FHIR

An MCP FHIR server written in Go for EMR systems like Epic and Cerner

de langcareInicial↓ 297/sem★ 70Actualizado hace 9 meses

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Model Context Protocol (MCP) Server for Fast Healthcare Interoperability Resources (FHIR) APIs

Model Context Protocol (MCP) Server for Fast Healthcare Interoperability Resources (FHIR) APIs
Table of Contents
Overview
Demo
Demo with HAPI FHIR server
Demo with EPIC Sandbox
Core Features
Prerequisites
Installation
Installing using PyPI Package
Installing from Source
Installing using Docker
Running the MCP Server with Docker
Using Docker Compose with WSO2 FHIR Server
Configuring any FHIR Server
Integration with MCP Clients
VS Code
Claude Desktop
MCP Inspector
Configuration
CLI Options
Environment Variables
Tools
Development \& Testing
Installing Development Dependencies
Running Tests

Overview

The FHIR MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with FHIR APIs. Designed for developers, integrators, and healthcare innovators, this server acts as a bridge between modern AI/LLM tools and healthcare data, making it easy to search, retrieve, and analyze clinical information.

Demo

Demo with HAPI FHIR server

This video showcases the MCP server's functionality when connected to a public HAPI FHIR server. This example showcases direct interaction with an open FHIR server that does not require an authorization flow.

https://github.com/user-attachments/assets/cc6ac87e-8329-4da4-a090-2d76564a3abf

Demo with EPIC Sandbox

This video showcases the MCP server's capabilities within the Epic EHR ecosystem. It demonstrates the complete OAuth 2.0 Authorization Code Grant flow.

https://github.com/user-attachments/assets/96b433f1-3e53-4564-8466-65ab48d521de

Core Features

MCP-compatible transport: Serves FHIR via stdio, SSE, or streamable HTTP

SMART-on-FHIR based authentication support: Securely authenticate with FHIR servers and clients

Response Filtering using FHIRPath: Filter resources and bundles returned by read and search operations using custom FHIRPath expressions to retrieve only the fields needed for the task, reducing payload sizes.

Tool integration: Integratable with any MCP client such as VS Code, Claude Desktop, and MCP Inspector

Prerequisites

Python 3.8+
uv (for dependency management)
An accessible FHIR API server.

Installation

You can use the FHIR MCP Server by installing our Python package, or by cloning this repository.

Installing using PyPI Package

Configure Environment Variables:

To run the server, you must set FHIR_SERVER_BASE_URL.

To enable authorization: Set FHIR_SERVER_BASE_URL, FHIR_SERVER_CLIENT_ID, FHIR_SERVER_CLIENT_SECRET, and FHIR_SERVER_SCOPES. Authorization is enabled by default.
To disable authorization: Set FHIR_SERVER_DISABLE_AUTHORIZATION to True.

By default, the MCP server runs on [http://localhost:8000](http://localhost:8000), and you can customize the host and port using FHIR_MCP_HOST and FHIR_MCP_PORT.

You can set these by exporting them as environment variables like below or by creating a .env file (referencing .env.example).

`bash export FHIR_SERVER_BASE_URL="" export FHIR_SERVER_CLIENT_ID="" export FHIR_SERVER_CLIENT_SECRET="" export FHIR_SERVER_SCOPES=""

export FHIR_MCP_HOST="localhost" export FHIR_MCP_PORT="8000" `

Install the PyPI package and run the server

bash uvx fhir-mcp-server

Installing from Source

Clone the repository: bash git clone cd

Create a virtual environment and install dependencies: bash uv venv source .venv/bin/activate uv pip sync requirements.txt Or with pip: bash python -m venv .venv source .venv/bin/activate pip install -r requirements.txt

Configure Environment Variables: Copy the example file and customize if needed: bash cp .env.example .env

Run the server: bash uv run fhir-mcp-server

Installing using Docker

Running the MCP Server with Docker

You can run the MCP server using Docker for a consistent, isolated environment.

Note on Authorization: When running the MCP server locally via Docker or Docker Compose, authorization should be disabled by setting the environment variable, FHIR_SERVER_DISABLE_AUTHORIZATION=True . This would be fixed in the future releases.

Build the Docker Image or pull the docker image from the container registry:

Build from source: bash docker build -t fhir-mcp-server .
Pull from GitHub Container Registry: bash docker pull ghcr.io/wso2/fhir-mcp-server:latest latest is built from the main branch. To use a release, pull its version tag instead, for example ghcr.io/wso2/fhir-mcp-server:0.11.0.

Configure Environment Variables

Copy the example environment file and edit as needed:

`bash cp .env.example .env

Edit .env to set your FHIR server, client credentials, etc.

Alternatively, you can pass environment variables directly with -e flags or use Docker secrets for sensitive values. See the Configuration section for details on available environment variables.

Run the Container

bash docker run --env-file .env -p 8000:8000 ghcr.io/wso2/fhir-mcp-server:latest

This will start the server and expose it on port 8000. Adjust the port mapping as needed.

Using Docker Compose with WSO2 FHIR Server

For a quick setup that includes both the FHIR MCP server and the WSO2 FHIR Server (with PostgreSQL), use the provided docker-compose.yml. This sets up an instant development environment for testing FHIR operations.

Prerequisites:

Docker and Docker Compose installed.

Set the Database Credentials:

Copy the example environment file and set DB_PASSWORD in .env. If you already have a .env, add the DB_USER, DB_PASSWORD and DB_NAME lines from .env.example to it instead.

   cp .env.example .env

Docker Compose reads .env automatically. DB_USER and DB_NAME default to postgres if not set. .env is excluded from Git; use a secrets manager for production deployments.

Run the Stack:

   docker compose up -d

This command will:

Start a PostgreSQL database container.
Launch the FHIR Server (connected to PostgreSQL) listening on http://localhost:8080/fhir/r4.
Build and run the FHIR MCP server container listening on http://localhost:8000, with FHIR_SERVER_BASE_URL set to http://wso2-fhir-server:8080/fhir/r4.

Access the Services:

FHIR MCP Server: http://localhost:8000
FHIR Server: http://localhost:8080/fhir/r4
To stop run docker compose down.

docker compose down removes the database data; use docker compose stop to keep it between runs.

Configure Additional Environment Variables:

If you need to customize OAuth or other settings, adjust the env variables in the docker-compose.yml. The compose file sets basic configuration; refer to the Configuration section for full options.

Configuring any FHIR Server

To use a different FHIR server, run the FHIR MCP server container with FHIR_SERVER_BASE_URL pointing to that server. The example below uses the HAPI FHIR server. Stop the default stack first if it's already running (docker compose down), as both use ports 8000 and 8080.

Create a network and start the HAPI FHIR server:

   docker network create fhir-network

docker run -d --name hapi-fhir-server --network fhir-network -p 127.0.0.1:8080:8080 docker.io/hapiproject/hapi:v8.4.0-2

HAPI FHIR listens on http://localhost:8080/fhir. This uses its built-in database, so data is lost when the container is removed.

Build and run the FHIR MCP server container:

   docker build -t fhir-mcp-server .

docker run -d --name fhir-mcp-server-hapi --network fhir-network -p 127.0.0.1:8000:8000 -e FHIR_SERVER_BASE_URL=http://hapi-fhir-server:8080/fhir -e FHIR_MCP_HOST=0.0.0.0 -e FHIR_SERVER_DISABLE_AUTHORIZATION=True fhir-mcp-server

The FHIR MCP server listens on http://localhost:8000.

Stop and clean up:

   docker rm -f fhir-mcp-server-hapi hapi-fhir-server

docker network rm fhir-network

For any other FHIR server, set FHIR_SERVER_BASE_URL to its base URL. If the FHIR server runs on your host rather than in Docker, use http://host.docker.internal: /... instead of localhost. On Linux, also add --add-host=host.docker.internal:host-gateway to the docker run command, and make sure the FHIR server listens on an address reachable from containers (for example 0.0.0.0, not only 127.0.0.1).

Integration with MCP Clients

The FHIR MCP Server is designed for seamless integration with various MCP clients.

VS Code

Add the following JSON block to your MCP configuration file in VS Code (> V1.104). You can do this by pressing Ctrl + Shift + P and typing MCP: Open User Configuration.

Streamable HTTP STDIO SSE

"servers": {

"fhir": { "type": "http", "url": "http://localhost:8000/mcp", } }

</td>

"servers": {

"fhir": { "command": "uv", "args": [ "-

Solo se muestra el principio; lee el resto en el repo

FHIR MCP Server

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Clínicas y saludi

Preguntas frecuentes

Alternativas

Mirobody

Google Health MCP

Langcare MCP FHIR

README del creador

Model Context Protocol (MCP) Server for Fast Healthcare Interoperability Resources (FHIR) APIs

Table of Contents

Overview

Demo

Demo with HAPI FHIR server

Demo with EPIC Sandbox

Core Features

Prerequisites

Installation

Installing using PyPI Package

Installing from Source

Installing using Docker

Running the MCP Server with Docker

Edit .env to set your FHIR server, client credentials, etc.

Using Docker Compose with WSO2 FHIR Server

Configuring any FHIR Server

Integration with MCP Clients

VS Code