mcpField
M
MCP Server for FHIR

MCP Server for FHIR

Local
github.com/quiquemzHealth3Updated 78w ago
Repository

About MCP Server for FHIR

MCP Server for FHIR is a C# server for developers working with FHIR R4 implementations. It provides CRUD, search, transaction, history, and server-capability operations for FHIR data.

Key features

  1. 01Create, read, update, and delete resources
  2. 02Search and count matching resources
  3. 03Retrieve resource history
  4. 04Execute FHIR transactions
  5. 05Inspect server versions and capabilities

Use cases

  1. 01Manage resources on a FHIR server
  2. 02Search FHIR data by criteria
  3. 03Check supported formats and resource types

MCP support

Exposes FHIR resource management, search, transaction, history, and capability operations as tools for MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fhir": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
Run commanddocker run -i --rm compose

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocicompose

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Server for FHIR

A C#-based Model Context Protocol (MCP) server that enables interaction with FHIR servers. This server is primarily designed for developers working with FHIR R4 implementations.

Demo

This demo highlights some of the MCP server's when combined with Claude client:

  1. Generating synthetic data
  2. Searching for patients and related resources
  3. Visualizing the results through a graphical representation.

Demo

Here is a link of the full demo: MCP Server Demo

Tools

CRUD, Search and Other Helpful Operations
  • CreateResource: Create a new resource on the server.
  • ReadResource: Retrieve a resource by its ID.
  • UpdateResource: Update an existing resource.
  • DeleteResource: Delete a resource from the server.
  • SearchResources: Search for resources based on specific criteria.
  • FindNumberOfResources: Count the number of resources that match a search criteria.
  • GetResourceHistory: Retrieve the history of a resource.
  • ExecuteTransaction: Execute a FHIR transaction.
FHIR Server Capability Statements
  • GetFhirVersion: Get the FHIR version of the server.
  • ListSupportedFormats: List the formats supported by the server.
  • ListResourceTypes: List the resource types supported by the server.
  • ListResourceCapabilities: List the capabilities of a specific resource type.

Getting Started

Use MCP Server in VS Code

For detailed setup information follow the official documentation.

You can use the configuration file located under .vscode/mcp.json. You need to update your path to point to the .csproj in you local machine.

Setting Up Infrastructure

To set up a local FHIR server environment, run:

docker compose up -d --wait

This will start two FHIR servers using Docker Compose:

  1. HAPI FHIR Server - Comes pre-loaded with sample data
  2. Azure FHIR Server - Starts with an empty database

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.