mcp-on-fhir

An interactive FHIR application with MCP (Model Context Protocol) Knowledge Graph capabilities.

Visit Server
Added on 3/28/2025

MCP on FHIR

An interactive FHIR application with MCP (Model Context Protocol) Knowledge Graph capabilities.

Prerequisites

  • Node.js v18 or later
  • npm or npx

Getting Started

This application integrates with Model Context Protocol (MCP) servers to provide knowledge graph capabilities. You can run the application with the built-in configuration.

Option 1: Using the Run Script

  1. Make the run script executable:

    chmod +x run.sh
    
  2. Run the application:

    ./run.sh
    

Option 2: Manual Setup

  1. Start the application:
    npm start
    

The application uses the mcp_config.json file to configure and start the necessary MCP servers automatically.

MCP Configuration

The application uses a mcp_config.json file to configure the MCP servers it connects to. By default, it connects to:

  • Memory server (for knowledge graph functionality)
  • FHIR server (for healthcare data)

You can modify the mcp_config.json file to add additional servers or change the configuration:

{
  "mcpServers": {
    "memory": {
      "enabled": true,
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "env": {
        "MEMORY_FILE_PATH": "./mcp-memory.json"
      }
    },
    "fhir": {
      "enabled": true,
      "url": "https://hapi.fhir.org/baseR4"
    }
  }
}

Accessing the Application

Once the application is running, you can access it at: http://localhost:8080

Troubleshooting Knowledge Graph Issues

If you experience issues with the Knowledge Graph:

  1. Check that the application has started properly
  2. Ensure that the MCP servers are configured correctly in mcp_config.json
  3. Try refreshing the browser
  4. Check the server logs for any error messages

Features

  • FHIR API Integration: Connect to FHIR servers to access healthcare data
  • Knowledge Graph: Visualize connected data through the MCP memory server
  • Chat Interface: Interact with a context-aware chat interface

License

MIT