FHIR

An experimental TypeScript MCP server for connecting to FHIR servers and providing core MCP functions

Health and wellness Developer tools #FHIR Connection #Resource Search #Medical Data Remote .TypeScript

rating : 2.5 points

downloads : 37

update time : 2025-04-28

What is @flexpa/mcp-fhir?

This is an MCP server that connects to a FHIR server, allowing users to access and manipulate FHIR resources through a unified interface.

How to use @flexpa/mcp-fhir?

You can set up and run the server through simple configuration and command-line tools, and then use it to query and manage FHIR resources.

Use Cases

Suitable for medical application developers and researchers who need to integrate FHIR data.

Main Features

List FHIR ResourcesSupports accessing the FHIR resource list via URI.

Search FHIR ResourcesPerform advanced searches by specifying resource types and parameters.

Read a Single FHIR ResourceRead a specific FHIR resource based on the URI.

Advantages and Limitations

Advantages

Easy to integrate with existing FHIR systems

Supports multiple FHIR resource types

Open source with high customizability

Limitations

Requires configuration of SMART on FHIR tokens

Only suitable for experimental environments, not for production deployment

How to Use

Install Dependencies

Run npm install to install all necessary dependencies.

Build the Server

Use the npm run build command to generate an executable file.

Start the Server

Run npm run watch in development mode for automatic rebuilds.

Usage Examples

Example 1: Query Patient InformationQuery the basic information of patients through the FHIR interface.

Example 2: Read a Specific Patient RecordRead the detailed information of a specified patient.

Frequently Asked Questions

How to set up SMART on FHIR tokens?

Can it be used in a production environment?

Related Resources

GitHub Repository

The hosting address for project code and documentation.

MCP Inspector

A tool for debugging the MCP server.

🚀 @flexpa/mcp-fhir

This is a TypeScript-based MCP server that connects to a FHIR server. It offers core MCP functionalities for interacting with FHIR resources.

⚠️ Important Note

This is an experimental demonstration and is not recommended for production use.

🚀 Quick Start

This is a TypeScript-based MCP server that connects to a FHIR server. It provides core MCP functionality for interacting with FHIR resources, including:

Accessing FHIR resources via fhir:// URIs
Offering the ability to search for FHIR resources

✨ Features

Resources

💡 Usage Tip

Here, "resources" refers to the MCP definition, not FHIR. MCP resources are the core primitives in the Model Context Protocol (MCP), allowing servers to expose data and content for clients to read and use as context for LLM interactions.

List and access FHIR resources via URIs
Return resources in FHIR JSON format
Support all FHIR resource types available in the FHIR server's CapabilityStatement

Tools

search_fhir - Search for FHIR resources
- Accept resourceType and searchParams as parameters
- Return FHIR search results
read_fhir - Read a single FHIR resource
- Accept uri as a parameter
- Return a FHIR resource in JSON format

📦 Installation

Configuration

The server requires the following environment variables:

FHIR_BASE_URL: The base URL of your FHIR server
FHIR_ACCESS_TOKEN: The SMART on FHIR access token for authentication

Steps

To use it with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fhir": {
      "command": "/path/to/@flexpa/mcp-fhir/build/index.js"
    },
    "env": {
      "FHIR_BASE_URL": "<FHIR_BASE_URL>",
      "FHIR_ACCESS_TOKEN": "<FHIR_ACCESS_TOKEN>"
    }
  }
}