sameeragunarathne/health-tool-mcp

Health Tool MCP Server

An MCP server for generating Ballerina packages and templates from FHIR specifications using the Ballerina health tool.

Quick Start

1. Setup Environment:

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

2. Install Ballerina Health Tool:

   bal dist pull 2201.12.9
   bal tool pull health
   

Prerequisites

• Python 3.8+
• Node.js and npm
• Ballerina 2201.12.8+ with health tool
• MCP Client (Claude Desktop, VS Code, etc.)

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "health-tool-mcp": {
      "command": "/absolute/path/to/health-tool-mcp/venv/bin/python",
      "args": ["/absolute/path/to/health-tool-mcp/src/fhir_tool_mcp.py"],
      "env": {}
    }
  }
}

VS Code

1. Add server configuration to mcp.json:

{
	"servers": {
		"health-tool-mcp": {
			"command": "/absolute/path/to/health-tool-mcp/venv/bin/python",
			"args": [
				"/absolute/path/to/health-tool-mcp/src/fhir_tool_mcp.py"
			],
			"transport": "stdio",
         "env": {}
		}
	},
	"inputs": []
}

2. Start the mcp server from VS Code

Available Tools

1. download_fhir_package

Download FHIR packages from registry.fhir.org using npm.

• Parameters: package_url (required), output_dir (optional)
• Example: https://registry.fhir.org/package/hl7.fhir.us.core%7C8.0.0

2. generate_ballerina_package

Generate Ballerina packages from FHIR specification files.

• Parameters: fhir_spec_path, package_name (required), output_dir, org_name, package_version, dependent_igs (optional)
• Example: Generate uscore401 package from FHIR specs

Usage Examples

Download and Generate Package

# Download US Core 8.0.0 and generate Ballerina package
Package URL: https://registry.fhir.org/package/hl7.fhir.us.core%7C8.0.0
Package name: uscore401
Organization: myorg

FHIR Package Registry

Find packages at registry.fhir.org. URL format:

https://registry.fhir.org/package/{package-name}%7C{version}

Examples:

• US Core 8.0.0: https://registry.fhir.org/package/hl7.fhir.us.core%7C8.0.0
• HL7 FHIR R4: https://registry.fhir.org/package/hl7.fhir.r4.core%7C4.0.1