Mirth Connect MCP Server — 18 Tools for Channel Development, Debugging, and CI/CD

by easysolutions906

382 downloads
Not rated
GitHub

About

The first and most comprehensive MCP server for Mirth Connect. 18 tools: parse channels, generate Rhino-compatible code, lint for anti-patterns, debug errors, diff channels between environments, extract SQL for DBA review, map channel dependencies, generate CI/CD deploy scripts,

Details

Author
easysolutions906
Downloads
382
Categories
Developer Tools

- Parse channels and generate Rhino-compatible code.
- Lint channels for anti-patterns and debug errors.
- Diff channels between environments.
- Extract SQL for DBA review and map channel dependencies.
- Generate CI/CD deploy scripts and estimate throughput.
- Convert inline code to templates, generate test messages, validate JavaScript.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mirth Connect MCP Server — 18 Tools for Channel Development, Debugging, and CI/CD
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

mirth_parse_channel

Parse a Mirth Connect channel XML export into structured JSON. Extracts channel name, source connector, destination connectors, transformer steps, filter rules, code templates, and channel properties.

mirth_analyze_channel

Analyze a Mirth channel for common issues: hardcoded IPs/ports, SQL injection risks, missing error handling, Rhino compatibility problems, large inline scripts, deprecated APIs, missing tags, and disabled destinations.

mirth_explain_channel

Generate a plain-English description of what a Mirth channel does: source type, data flow, transformations, destinations, filters, and error handling.

mirth_generate_transformer

Generate a Mirth transformer step (JavaScript for Rhino). Follows Rhino rules: var at root level, const/arrow functions inside IIFEs, no let, no template literals, no destructuring.

mirth_generate_filter

Generate a Mirth filter step given criteria. Returns true to accept a message, false to reject. Common uses: filter by message type (ADT^A01), exclude test patients, check field values.

mirth_generate_channel

Generate a complete Mirth channel XML given a description. Produces valid XML that can be imported directly into Mirth Connect.

mirth_map_fields

Generate HL7 field mapping transformer code. Maps source HL7 fields (e.g., PID-5-1) to target variables. Supports output to channelMap, JSON, or XML.

mirth_generate_code_template

Generate a Mirth code template (reusable function library). Uses the IIFE pattern with var declarations for public API. All internal logic uses const/arrow functions inside the IIFE.

mirth_debug_error

Debug a Mirth Connect error message or stack trace. Explains what went wrong and suggests fixes. Handles common Rhino errors, Java interop issues, database errors, network failures, and memory problems.

mirth_validate_js

Validate JavaScript code for Mirth/Rhino compatibility across different Mirth versions. Detects ES5-only issues (pre-3.7), ES6 warnings (3.7+), and syntax never supported in any Rhino version. Returns a version compatibility matrix showing which Mirth versions the code is safe for.

mirth_diff_channels

Compare two Mirth channel XML exports and show what changed. Detects added/removed/modified destinations, transformer steps, connector properties, and scripts. Essential for environment promotion reviews.

mirth_migration_guide

Generate a migration guide for upgrading a Mirth channel to a newer version. Identifies deprecated APIs, Rhino compatibility issues, and breaking changes between Mirth 3.x, 4.x, and 4.5+.

mirth_extract_sql

Extract all SQL queries from a Mirth channel — Database Reader/Writer connectors, transformer scripts, and filter scripts. Flags potential SQL injection vulnerabilities. Useful for DBA review and security audits.

mirth_dependency_map

Map dependencies between Mirth channels. Detects Channel Writer/Reader connections and router.routeMessage calls. Pass multiple channel XMLs to build a complete dependency graph. Identifies orphan channels with no connections.

mirth_generate_deploy_script

Generate a bash deploy script for a Mirth channel using the Mirth REST API. Handles login, check-if-exists, stop, update-or-create, deploy, and start. Ready for CI/CD pipelines.

mirth_convert_to_code_template

Convert inline JavaScript from a transformer step into a proper Mirth code template with the IIFE pattern. Extracts functions, wraps them in the standard var/IIFE structure, and generates usage examples.

mirth_estimate_throughput

Estimate message throughput for a Mirth channel by analyzing transformer complexity, database queries, HTTP calls, regex operations, and destination types. Identifies bottlenecks and suggests optimizations.

mirth_generate_test_message

Generate a realistic test message for a Mirth channel based on its source connector type. Produces HL7 for TCP/LLP sources, JSON for HTTP sources, and delimited text for file sources.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mirth connect mcp server \u2014 18 tools for channel development, debugging, and ci/cd": {
            "mirth": {
                "command": "npx",
                "args": [
                    "-y",
                    "@easysolutions906/mirth-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "mirth": {
        "command": "npx",
        "args": [
            "-y",
            "@easysolutions906/mirth-mcp"
        ]
    }
}

The first and most comprehensive MCP server for Mirth Connect. 18 tools: parse channels, generate Rhino-compatible code, lint for anti-patterns, debug errors, diff channels between environments, extract SQL for DBA review, map channel dependencies, generate CI/CD deploy scripts, estimate throughput, convert inline code to templates, generate test messages, and validate JavaScript for Rhino compatibility. Built for healthcare integration developers.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.