Сервер dicom-mcp позволяет ассистентам ИИ запрашивать, читать и перемещать данные на серверах DICOM (PACS, VNA и др.).

🤝 Вносить вклад • 📝 Сообщить о баге • 📝 Пост в блоге 1

✨ Основные возможности

dicom-mcp предоставляет инструменты для:

• ** 🔍 Запрос метаданных**: Поиск пациентов, исследований, серий и экземпляров по различным критериям.
• ** 📄 Прочитать отчёты DICOM (PDF)**: Получить экземпляры DICOM с инкапсулированными PDF-файлами (например, клинические отчёты) и извлечь текстовое содержимое.
• ** ➡️ Отправлять изображения DICOM**: Отправлять серии или исследования другим целям DICOM, например, конечным точкам ИИ для сегментации, классификации изображений и т.д.
• ** ⚙️ Утилиты**: Управление соединениями и понимание вариантов запросов.

🚀 Быстрый старт

📥 Установка

Установка с помощью UV или pip:

Или клонируя репозиторий:

⚙️ Конфигурация

dicom-mcp требует конфигурационный файл YAML (config.yaml или аналогичный), определяющий узлы DICOM и вызывающий заголовки AE. Адаптируйте конфигурацию или оставите как есть для совместимости с примерным сервером ORTHANC.

[! ВНИМАНИЕ] DICOM-MCP не предназначен для клинического применения и не должен быть связан с живыми базами данных больниц или базами данных с чувствительными для пациентов данными.

DICOM MCP Server for Medical Imaging Systems 🏥

The dicom-mcp server enables AI assistants to query, read, and move data on DICOM servers (PACS, VNA, etc.).

---------------------------------------------------------------------
🧑‍⚕️ User: "Any significant findings in John Doe's previous CT report?"

🧠 LLM → ⚙️ Tools:
   query_patients → query_studies → query_series → extract_pdf_text_from_dicom

💬 LLM Response: "The report from 2025-03-26 mentions a history of splenomegaly (enlarged spleen)"

🧑‍⚕️ User: "What's the volume of his spleen at the last scan and the scan today?"

🧠 LLM → ⚙️ Tools:
   (query_studies → query_series → move_series → query_series → extract_pdf_text_from_dicom) x2
   (The move_series tool sends the latest CT to a DICOM segmentation node, which returns volume PDF report)

💬 LLM Response: "last year 2024-03-26: 412cm³, today 2025-04-10: 350cm³"
---------------------------------------------------------------------

✨ 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:

uv tool install dicom-mcp

Or by cloning the repository:

# Clone and set up development environment
git clone https://github.com/ChristianHinge/dicom-mcp
cd dicom mcp

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install with test dependencies
uv pip install -e ".[dev]"

⚙️ 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.

nodes:
  main:
    host: "localhost"
    port: 4242 
    ae_title: "ORTHANC"
    description: "Local Orthanc DICOM server"

current_node: "main"
calling_aet: "MCPSCU" 

[!WARNING]