fhir-mcp-server
by the-momentum·★ 80·Score 43
A production-ready MCP server for FHIR healthcare data integration with Claude Desktop.
Overview
FHIR MCP Server implements a complete Model Context Protocol server designed to enable seamless interaction between LLM-based agents and FHIR-compliant healthcare systems. It provides full CRUD operations on FHIR resources through a comprehensive suite of tools accessible from MCP-compatible clients like Claude Desktop. The server features FastMCP framework, intelligent document processing, semantic search using vector embeddings, OAuth2 authentication, and LOINC medical terminology integration.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose this server when working with healthcare data and need natural language access to FHIR-compliant systems with secure authentication.
When NOT to choose this
Avoid if you don't have access to a FHIR server or need broader healthcare data management beyond what FHIR provides.
Tools this server exposes
12 tools extracted from the READMErequest_patient_resourceManage patient demographic and administrative information
request_observation_resourceHandle clinical measurements and assessments
request_condition_resourceManage patient problems and diagnoses
request_medication_resourceHandle medication information and orders
request_encounter_resourceHandle patient visits and interactions
request_allergy_intolerance_resourceManage patient allergy information
request_generic_resourceOperate on any FHIR resource not covered by specific tools
add_document_to_pineconeIngests documents into the vector database for semantic search
search_pineconePerforms semantic search across indexed documents using vector embeddings
get_loinc_codesRetrieves standardized LOINC codes for medical observations and laboratory tests
request_document_reference_resourceManage FHIR DocumentReference resources
request_immunization_resourceManage vaccination records
Comparable tools
Installation
Installation
- Clone the repository:
``sh git clone https://github.com/the-momentum/fhir-mcp-server cd fhir-mcp-server ``
- Set up environment variables:
``sh cp config/.env.example config/.env # Edit config/.env with your credentials ``
- Install Dependencies
```sh # Docker method make build
# uv method make uv ```
- Update Claude Desktop configuration (claude_desktop_config.json):
``json { "mcpServers": { "fhir-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "--init", "--name", "fhir-mcp-server", "--mount", "type=bind,source=<your-project-path>/app,target=/root_project/app", "--mount", "type=bind,source=<your-project-path>/config/.env,target=/root_project/config/.env", "-e", "TRANSPORT_MODE=stdio", "mcp-server:latest" ] } } } ``
FAQ
- What FHIR resources does the server support?
- The server provides tools for all major FHIR resources with specific tools for selected resource types and a generic tool for others. It covers patient, condition, medication, encounter, and observation resources.
- How is sensitive data protected in the configuration?
- The server includes built-in encryption for sensitive configuration values like API keys and passwords. It provides both automated and manual setup options for encryption.
Compare fhir-mcp-server with
Last updated · Auto-generated from public README + GitHub signals.