ChristianHinge/dicom-mcp

The dicom-mcp server enables AI assistants to query, read, and move data on DICOM servers (PACS, VNA, etc.).
🤝 **Contribute** •
📝 **Report Bug** •
📝 **Blog Post 1**
✨ Core Capabilities
dicom-mcp provides tools to:
* **🔍 Query Metadata**: Search for patients, studies, series, and instances using various criteria.
* **📄 Read DICOM Reports (PDF)**: Retrieve DICOM instances containing encapsulated PDFs (e.g., clinical reports) and extract the text content.
* **➡️ Send DICOM Images**: Send series or studies to other DICOM destinations, e.g. AI endpoints for image segmentation, classification, etc.
* **⚙️ Utilities**: Manage connections and understand query options.
🚀 Quick Start
📥 Installation
Install using uv or pip:
Or by cloning the repository:
⚙️ Configuration
dicom-mcp requires a YAML configuration file (config.yaml or similar) defining DICOM nodes and calling AE titles. Adapt the configuration or keep as is for compatibility with the sample ORTHANC Server.
> [!WARNING]
DICOM-MCP is not meant for clinical use, and should not be connected with live hospital databases or databases with patient-sensitive data. Doing so could lead to both loss of patient data, and leakage of patient data onto the internet. DICOM-MCP can be used with locally hosted open-weight LLMs for complete data privacy.
(Optional) Sample ORTHANC server
If you don't have a DICOM server available, you can run a local ORTHANC server using Docker:
Clone the repository and install test dependencies pip install -e ".[dev]
UI at http://localhost:8042
🔌 MCP Integration
Add to your client configuration (e.g. claude_desktop_config.json):
For development:
🛠️ Tools Overview
dicom-mcp provides four categories of tools for interaction with DICOM servers and DICOM data.
🔍 Query Metadata
* **query_patients**: Search for patients based on criteria like name, ID, or birth date.
* **query_studies**: Find studies using patient ID, date, modality, description, accession number, or Study UID.
* **query_series**: Locate series within a specific study using modality, series number/description, or Series UID.
* **query_instances**: Find individual instances (images/objects) within a series using instance number or SOP Instance UID
📄 Read DICOM Reports (PDF)
* **extract_pdf_text_from_dicom**: Retrieve a specific DICOM instance containing an encapsulated PDF and extract its text content.
➡️ Send DICOM Images
* **move_series**: Send a specific DICOM series to another configured DICOM node using C-MOVE.
* **move_study**: Send an entire DICOM study to another configured DICOM node using C-MOVE.
⚙️ Utilities