VimukthiRajapaksha/healthcare-mcp-server

Model Context Protocol (MCP) Server for Healthcare

Overview

This server allows you to search for FHIR (Fast Healthcare Interoperability Resources) resources on a specified FHIR server. It is built with Python and supports command-line, Docker, and VS Code integration.

Prerequisites

• Python 3.8+
• uv (for dependency management)
• An accessible FHIR server (defaults to the public HAPI FHIR test server)

Setup

1. Clone the repository:

   git clone <repository_url>
   cd <repository_directory>
   

2. Create a virtual environment and install dependencies:

   uv venv
   source .venv/bin/activate
   uv pip sync requirements.txt
   

   Or with pip:

   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt
   

3. Configure Environment Variables: Copy the example file and customize if needed:

   cp .env.example .env
   

Usage

Run the server:

uv run server.py

VS Code Integration

Add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

"mcp": {
    "servers": {
        "fhir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:8000/mcp"
            ]
        }
    }
}

"mcp": {
    "servers": {
        "fhir": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/fhir-mcp-server",
                "run",
                "fhir-mcp-server",
                "--transport",
                "stdio"
            ],
            "env": {
                "HEALTHCARE_MCP_FHIR__ACCESS_TOKEN": "Your FHIR Access Token"
            }
        }
    }
}

Claude Desktop Integration

Add the following JSON block to your Claude Desktop settings to connect to your local MCP server.

• Launch the Claude Desktop app, click on the Claude menu in the top bar, and select "Settings…".
• In the Settings pane, click “Developer” in the left sidebar. Then click "Edit Config". This will open your configuration file in your file system. If it doesn’t exist yet, Claude will create one automatically at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• Open the claude_desktop_config.json file in any text editor. Replace its contents with the following JSON block to register the MCP server:

{
    "mcpServers": {
        "fhir": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "http://localhost:8000/mcp"
            ]
        }
    }
}

{
    "mcpServers": {
        "fhir": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/fhir-mcp-server",
                "run",
                "fhir-mcp-server",
                "--transport",
                "stdio"
            ],
            "env": {
                "HEALTHCARE_MCP_FHIR__ACCESS_TOKEN": "Your FHIR Access Token"
            }
        }
    }
}

MCP Inspector Integration

Follow these steps to get the MCP Inspector up and running:

• Open a terminal and run the following command:

  npx -y @modelcontextprotocol/inspector

• In the MCP Inspector interface:

Make sure your MCP server is already running and listening on the above endpoint.

Once connected, MCP Inspector will allow you to visualize tool invocations, inspect request/response payloads, and debug your tool implementations easily.

Example Prompts

• Get allergy history for patient 53373
• Fetch the immunization records for patient ID 53373
• List all active care plans for patient 22
• Provide a consolidated report for patient 53373 that includes their complete allergy history as well as all available immunization records, organized by date and highlighting any critical alerts
• Retrieve all active care plans for patient ID 22 and present them in a markdown table showing each plan’s ID, title, status, intent, and start date