FHIR MCP Server

Name: FHIR MCP Server
Author: wso2

von wso2Version 0.11.0i★ 137iLäuft auf deinem Computer

Name in der Registryio.github.wso2/fhir-mcp-server

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi3 von 3 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiWachsend↓ 823/Wo. · ★ 137

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Praxen & Gesundheit
Das musst du eintragen: FHIR_SERVER_BASE_URL

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 3 von 3 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: FHIR_SERVER_BASE_URL

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

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

Führe das in deinem Terminal aus

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

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

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

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto wso2 bestätigt, dem das Repo gehört
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 6 Tagen
✓ Bestanden
Hat eine Lizenz
Nutzt Apache-2.0
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Praxen & Gesundheiti

Mehr Sterne als 100 % der anderen 1027 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 71 % der anderen 1027 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1027 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist FHIR MCP Server sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: FHIR_SERVER_BASE_URL

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.11.0) kam vor 10 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mirobody, Google Health MCP, Langcare MCP FHIR

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mirobody

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

von thetahealthWachsend↓ 290/Wo.★ 1408Aktualisiert gestern

Läuft auf deinem Computer✓ thetahealth.ai

Installieren

Google Health MCP

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

von davidmosiahWachsend↓ 1024/Wo.★ 79Aktualisiert vor 4 Monaten

Läuft auf deinem Computer

Installieren

Langcare MCP FHIR

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

von langcareAm Anfang↓ 297/Wo.★ 70Aktualisiert vor 9 Monaten

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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": [ "-

Nur der Anfang wird gezeigt; den Rest findest du im Repo

FHIR MCP Server

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Praxen & Gesundheiti

Häufige Fragen

Alternativen

Mirobody

Google Health MCP

Langcare MCP FHIR

README vom Entwickler

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