# DICOM/HL7/FHIR Interoperability MCP Server

Inspect DICOM tags and HL7v2 messages, map data to FHIR, or connect to PACS. Built for healthcare interoperability work.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: NyxToolsDev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NyxToolsDev/dicom-hl7-mcp-server
- Updated: 2026-07-29
- HTML: https://affpapa.org/en/nevibecode/mcp/dicomhl7fhir-interoperability-mcp-server

## What it does

Free reference tools look up DICOM tags, describe vendor-specific quirks, and turn HL7 v2.x messages into readable output. Licensed tools map DICOM fields to HL7v2 and HL7v2 to FHIR R4, validate messages, and create Mirth Connect channel configurations.

PACS features cover study searches, metadata retrieval, and image transfer through C-MOVE; DICOMweb is supported too. Premium features need a `DICOM_HL7_LICENSE_KEY`, and PACS access needs connection settings. PACS results contain PHI. C-MOVE starts disabled, and sending PHI to a cloud LLM depends on your organization’s policies.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `DICOM_HL7_LICENSE_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add dicom-hl7-mcp-server -e DICOM_HL7_LICENSE_KEY=<DICOM_HL7_LICENSE_KEY> -- uvx dicom-hl7-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dicom-hl7-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add dicomhl7fhir-interoperability-mcp-server --env DICOM_HL7_LICENSE_KEY=<DICOM_HL7_LICENSE_KEY> -- uvx dicom-hl7-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dicom-hl7-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dicomhl7fhir-interoperability-mcp-server": {
            "command": "uvx",
            "args": [
                "dicom-hl7-mcp"
            ],
            "env": {
                "DICOM_HL7_LICENSE_KEY": "<DICOM_HL7_LICENSE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dicom-hl7-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dicomhl7fhir-interoperability-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "dicom-hl7-mcp"
            ],
            "env": {
                "DICOM_HL7_LICENSE_KEY": "<DICOM_HL7_LICENSE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dicom-hl7-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DICOM_HL7_LICENSE_KEY=<DICOM_HL7_LICENSE_KEY> dicomhl7fhir-interoperability-mcp-server uvx dicom-hl7-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dicom-hl7-mcp <command>

## When to use it
- look up a DICOM tag by number or keyword
- read an HL7 v2.x message as structured text
- map HL7v2 fields to FHIR R4 resources
- generate a Mirth Connect channel configuration
- search PACS for a study and retrieve its metadata

## Example prompts
- Look up DICOM tag `(0008,0050)` and describe any vendor-specific details.
- Parse this HL7 v2.x message and explain the PID segment fields.
- Map the fields in this HL7v2 message to FHIR R4 resources.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md