FHIR MCP Server

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

io.github.wso2/fhir-mcp-server · Repository · Website · version 0.10.0 · 132 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx fhir-mcp-server

Needs credentials: FHIR_SERVER_BASE_URL. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading aiohttp (1.6MiB)
 Downloaded aiohttp
Installed 41 packages in 138ms
/home/runner/.cache/uv/archive-v0/jrUrBSXsk5fnYEMy/lib/python3.13/site-packages/pydantic_settings/sources/utils.py:47: IncompleteFieldDefinitionWarning: Field 'lifespan' has an incomplete definition: its annotation contains an unresolved forward reference, so settings sources may fail to correctly resolve its value. Call `model_rebuild()` on the model where the field is defined, once all the referenced types are defined.
  warnings.warn(
[2026-08-16 03:00:56,706] INFO {fhir_mcp_server.server.main:809} - Starting FHIR MCP server with streamable-http transport
INFO:     Started server process [10963]
INFO:     Waiting for application startup.
[2026-08-16 03:00:56,822] INFO {mcp.server.streamable_http_manager.run:109} - StreamableHTTP session manager started
INFO:     Application startup complete.
ERROR:    [Errno 98] error while attempting to bind on address ('::1', 8000, 0, 0): [errno 98] address already in use
INFO:     Waiting for application shutdown.
[2026-08-16 03:00:56,824] INFO {mcp.server.streamable_http_manager.run:113} - StreamableHTTP session manager shutting down
INFO:     Application shutdown complete.

macOS

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Building aiohttp==3.12.13
      Built aiohttp==3.12.13
Installed 41 packages in 451ms
/Users/runner/.cache/uv/archive-v0/ISzznKueuvQZmH_g/lib/python3.14/site-packages/pydantic_settings/sources/utils.py:47: IncompleteFieldDefinitionWarning: Field 'lifespan' has an incomplete definition: its annotation contains an unresolved forward reference, so settings sources may fail to correctly resolve its value. Call `model_rebuild()` on the model where the field is defined, once all the referenced types are defined.
  warnings.warn(
[2026-08-16 03:04:09,875] INFO {fhir_mcp_server.server.main:809} - Starting FHIR MCP server with streamable-http transport
INFO:     Started server process [45572]
INFO:     Waiting for application startup.
[2026-08-16 03:04:10,090] INFO {mcp.server.streamable_http_manager.run:109} - StreamableHTTP session manager started
INFO:     Application startup complete.
ERROR:    [Errno 48] error while attempting to bind on address ('127.0.0.1', 8000): [errno 48] address already in use
INFO:     Waiting for application shutdown.
[2026-08-16 03:04:10,103] INFO {mcp.server.streamable_http_manager.run:113} - StreamableHTTP session manager shutting down
INFO:     Application shutdown complete.

Windows

timed out2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32001: Request timed out
--- stderr (tail) ---
Installed 42 packages in 10.54s
C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\aV3J7yZAl0Zw4r4h\Lib\site-packages\pydantic_settings\sources\utils.py:47: IncompleteFieldDefinitionWarning: Field 'lifespan' has an incomplete definition: its annotation contains an unresolved forward reference, so settings sources may fail to correctly resolve its value. Call `model_rebuild()` on the model where the field is defined, once all the referenced types are defined.
  warnings.warn(
[2026-08-16 04:24:25,628] INFO {fhir_mcp_server.server.main:809} - Starting FHIR MCP server with streamable-http transport
INFO:     Started server process [4012]
INFO:     Waiting for application startup.
[2026-08-16 04:24:26,271] INFO {mcp.server.streamable_http_manager.run:109} - StreamableHTTP session manager started
INFO:     Application startup complete.
INFO:     Uvicorn running on http://localhost:8000 (Press CTRL+C to quit)

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.wso2__fhir-mcp-server.json)](https://doesitinstall.com/s/io.github.wso2__fhir-mcp-server.html)