mcp-fhir-tools

v1.0.1

Published

3 months ago

Tools for adding FHIR capabilities to LLMs.

Downloads

0High
0Medium
0Low

johngrimes

FHIR LLM Model Context Protocol MCP

FHIR Tools

Tools for working with FHIR resources, including validation and identifier generation.

Features

FHIR Resource Validation

Validates FHIR resources against the official FHIR validator, supporting multiple FHIR versions and SNOMED CT editions.

UUID Generation

Generates random UUID v4 strings for use as unique identifiers in FHIR resources.

Installation

Adding to Claude Desktop

To add this tool to your Claude Desktop configuration:

Open Claude Desktop and go to Settings > Developer Settings
Find your Claude desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following to your configuration file:

{
  "mcpServers": {
    "fhir-tools": {
      "command": "npx",
      "args": ["-y", "mcp-fhir-tools"]
    }
  }
}

If you already have other MCP servers configured, just add the "fhir-tools" entry to the existing "mcpServers" object
Save the file and restart Claude Desktop
You should now see the FHIR Tools available in the tools menu (hammer icon)

Adding to Goose

To add this tool as a Command-Line Extension in Goose:

Run goose configure in your terminal.
Select Add Extension from the menu.
Choose Command-line Extension.
When prompted for "What would you like to call this extension?", you can enter a descriptive name, for example, "FHIR Tools".
For "What command should be run?", enter:
```
npx -y mcp-fhir-tools
```
You can set a timeout (e.g., 300 seconds) or accept the default.
Choose whether to add environment variables (not required for this tool).

Goose will then confirm that the extension has been added. You can enable or disable it via goose configure > Toggle Extensions.

Usage

Starting the Server

CLI Mode (stdio)

bun run start-stdio

Web Server Mode (SSE)

bun run start-sse

This starts a server on port 3003 that can be accessed via Server-Sent Events (SSE).

Tool Documentation

validate

Validates a FHIR resource using the official FHIR validator.

Parameters:

resource: FHIR resource in JSON format
fhirVersion: The version of FHIR to validate against (4.0.1, 1.0.2, etc.)
snomedVersion: SNOMED CT version to use for validation (intl, us, uk, au, etc.)
txServer (optional): URL of the terminology server to use. If not provided, the validator's default (often tx.fhir.org) is used. For Australian FHIR content, use https://tx.dev.hl7.org.au/fhir.

generate-uuid

Generates a random UUID v4 string.

Parameters: None