Servidor DICOM MCP

Servidor DICOM MCP para sistemas de imágenes médicas 🏥

El servidor dicom-mcp permite a los asistentes de IA consultar, leer y mover datos en servidores DICOM (PACS, VNA, etc.).

🤝 Contribuir • 📝 Informar un error • 📝 Publicación del blog

✨ Capacidades principales

dicom-mcp proporciona herramientas para:

🔍 Consultar metadatos : busca pacientes, estudios, series e instancias utilizando diversos criterios.
📄 Leer informes DICOM (PDF) : recupere instancias DICOM que contengan PDF encapsulados (por ejemplo, informes clínicos) y extraiga el contenido del texto.
➡️ Enviar imágenes DICOM : envía series o estudios a otros destinos DICOM, por ejemplo, puntos finales de IA para segmentación de imágenes, clasificación, etc.
⚙️ Utilidades : Administrar conexiones y comprender las opciones de consulta.

🚀 Inicio rápido

📥 Instalación

Instalar usando uv o pip:

uv tool install dicom-mcp

O clonando el repositorio:

# 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]"

⚙️ Configuración

dicom-mcp requiere un archivo de configuración YAML ( config.yaml o similar) que define los nodos DICOM y llama a los títulos AE. Adapte la configuración o manténgala tal cual para garantizar la compatibilidad con el servidor ORTHANC de ejemplo.

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

current_node: "main"
calling_aet: "MCPSCU" 

[!NOTA] DICOM-MCP es un proyecto de código abierto que no está diseñado para uso clínico y, por lo tanto, no debe conectarse con bases de datos hospitalarias activas ni con datos sensibles de pacientes. Esto podría provocar la pérdida y filtración de datos de pacientes en internet.

(Opcional) Servidor ORTHANC de muestra

Si no tiene un servidor DICOM disponible, puede ejecutar un servidor ORTHANC local usando Docker:

Clonar el repositorio e instalar las dependencias de prueba pip install -e ".[dev]

cd tests
docker ocmpose up -d
cd ..
pytest # uploads dummy pdf data to ORTHANC server
sh upload_dummy_data.sh

Interfaz de usuario en http://localhost:8042

🔌 Integración MCP

Agregue a su configuración de cliente (por ejemplo, claude_desktop_config.json ):

{
  "mcpServers": {
    "dicom": {
      "command": "uv",
      "args": ["tool","dicom-mcp", "/path/to/your_config.yaml"]
    }
  }
}

Para desarrollo:

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/dicom-mcp",
                "run",
                "dicom-mcp",
                "/path/to/your_config.yaml"
            ]
        }
    }
}

🛠️ Descripción general de las herramientas

dicom-mcp proporciona cuatro categorías de herramientas para la interacción con servidores DICOM y datos DICOM.

🔍 Consultar metadatos

query_patients : busca pacientes según criterios como nombre, ID o fecha de nacimiento.
query_studies : busca estudios utilizando el ID del paciente, la fecha, la modalidad, la descripción, el número de acceso o el UID del estudio.
query_series : ubica series dentro de un estudio específico usando modalidad, número/descripción de serie o UID de serie.
query_instances : busca instancias individuales (imágenes/objetos) dentro de una serie usando el número de instancia o el UID de instancia SOP

📄 Leer informes DICOM (PDF)

extract_pdf_text_from_dicom : recupera una instancia DICOM específica que contiene un PDF encapsulado y extrae su contenido de texto.

➡️ Enviar imágenes DICOM

move_series : envía una serie DICOM específica a otro nodo DICOM configurado mediante C-MOVE.
move_study : envía un estudio DICOM completo a otro nodo DICOM configurado mediante C-MOVE.

⚙️ Utilidades

list_dicom_nodes : muestra el nodo DICOM actualmente activo y enumera todos los nodos configurados.
switch_dicom_node : cambia el nodo DICOM activo para operaciones posteriores.
verify_connection : prueba la conexión de red DICOM al nodo actualmente activo usando C-ECHO.
get_attribute_presets : enumera los niveles de detalle disponibles (mínimo, estándar, extendido) para los resultados de la consulta de metadatos.

Ejemplo de interacción

Las herramientas se pueden encadenar para responder preguntas complejas:

---------------------------------------------------------------------
🧑‍⚕️ 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³"
---------------------------------------------------------------------

📈 Contribuyendo

Ejecución de pruebas

Las pruebas requieren un servidor DICOM Orthanc en ejecución. Puedes usar Docker:

# Navigate to the directory containing docker-compose.yml (e.g., tests/)
cd tests
docker-compose up -d

Ejecutar pruebas usando pytest:

# From the project root directory
pytest

Detener el contenedor de Orthanc:

cd tests
docker-compose down

Depuración

Utilice el Inspector MCP para depurar la comunicación del servidor:

npx @modelcontextprotocol/inspector uv run dicom-mcp /path/to/your_config.yaml --transport stdio

🙏 Agradecimientos

Construido con pynetdicom
Utiliza PyPDF2 para la extracción de texto PDF

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Permite a los asistentes de IA consultar y analizar metadatos de imágenes médicas de servidores DICOM, incluida información de pacientes, estudios, series e instancias, así como extraer texto de documentos PDF encapsulados.

Related MCP Servers

medRxiv-MCP-Server
JackKuo666
-
security
F
license
-
quality
🔍 Enable AI assistants to search and access medRxiv papers through a simple MCP interface. The medRxiv MCP Server provides a bridge between AI assistants and medRxiv's preprint repository through the Model Context Protocol (MCP). It allows AI models to search for health sciences preprints and acce
Last updated -
1
Python
MedAdapt Content Server
ryoureddy
-
security
A
license
-
quality
A specialized Model Context Protocol server that enhances AI-assisted medical learning by connecting Claude Desktop to PubMed, NCBI Bookshelf, and user documents for searching, retrieving, and analyzing medical education content.
Last updated -
Python
MIT License
Healthcare MCP Server
Cicatriiz
-
security
F
license
-
quality
A Model Context Protocol server providing AI assistants with access to healthcare data tools, including FDA drug information, PubMed research, health topics, clinical trials, and medical terminology lookup.
Last updated -
111
14
JavaScript
Dixa MCP Server
ktabori
-
security
A
license
-
quality
A FastMCP server implementation for the Dixa API, enabling AI assistants to search, retrieve, and manage customer conversation data and tags.
Last updated -
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

New MCP Servers

KiCad MCP Server

DICOM MCP Server