This MCP server exposes a FHIR-focused Model Context Protocol endpoint that bridges interactions between a FHIR API server and MCP clients. It supports standard MCP transport modes and SMART-on-FHIR based authentication to securely access FHIR resources. With the server running, you can query, search, and fetch FHIR resources through MCP-compatible tooling, and leverage integration points with popular MCP clients such as VS Code, Claude Desktop, and MCP Inspector. The server configuration is designed to be used with the uvx runner for Python installations, and it relies on environment variables to control the FHIR backend and OAuth behavior. To start using it, install the Python package (fhir-mcp-server) via uvx and set the required environment variables, then run the MCP server to listen on the configured host/port. Tools integrated with this server enable you to connect, browse, and test FHIR operations within your preferred MCP ecosystem.

Prerequisites: Python 3.8+, uv (for dependency management) or uvx via PyPI, and an accessible FHIR API server. The MCP server is distributed as a Python package (fhir-mcp-server).

Installing using PyPI Package

1. Configure Environment Variables (example):

FHIR_SERVER_BASE_URL="" FHIR_SERVER_CLIENT_ID="" FHIR_SERVER_CLIENT_SECRET="" FHIR_SERVER_SCOPES=""

FHIR_MCP_HOST="localhost" FHIR_MCP_PORT="8000"

2. Install the package and run the server:

uvx fhir-mcp-server

Installing from Source

1. Clone the repository:

git clone <repository_url> cd <repository_directory>

2. Create and activate a virtual environment, then install dependencies:

uv venv source .venv/bin/activate uv pip sync requirements.txt

Or with pip:

python -m venv .venv source .venv/bin/activate pip install -r requirements.txt

3. Configure Environment Variables (copy example and customize as needed):

cp .env.example .env

4. Run the server:

uv run fhir-mcp-server

Installing using Docker

1. Build or pull the image:

docker build -t fhir-mcp-server .

or

docker pull wso2/fhir-mcp-server:latest

2. Configure environment variables (via .env or -e flags) and run:

docker run --env-file .env -p 8000:8000 fhir-mcp-server

3. Optional: use Docker Compose with a HAPI FHIR server setup as described in the repository documentation.

Notes and tips: - By default the MCP server runs on http://localhost:8000; adjust FHIR_MCP_HOST and FHIR_MCP_PORT to suit your environment. - If you rely on OAuth, ensure FHIR_SERVER_BASE_URL, FHIR_SERVER_CLIENT_ID, FHIR_SERVER_CLIENT_SECRET, and FHIR_SERVER_SCOPES are set; to disable authorization, set FHIR_SERVER_DISABLE_AUTHORIZATION=True. - When running via Docker, authorization should be disabled for local testing as described in the Docker section. - The server supports MCP transport over stdio, SSE, or HTTP streaming depending on the client and configuration. - Review the .env.example for a full list of environment variables and their intended usage.