Servidor DICOM MCP

Un servidor de Protocolo de Contexto Modelo (MCP) para pruebas de conectividad DICOM.

Prerrequisitos

1. Instalar UV (obligatorio):

   pip install uv

   Asegúrese de que uv esté disponible en la RUTA de su sistema, ya que es necesario para que Claude ejecute el servidor correctamente.

Related MCP server: Echo MCP Server

Instalación

Hay dos formas de configurar el servidor:

1. Configuración tradicional

Instale las dependencias necesarias:

uv pip install mcp[cli]

2. Instalación del MCP (recomendado)

Para utilizar este servidor con el Protocolo de Contexto Modelo de Claude:

mcp install server.py

Esto registrará el servidor con Claude para operaciones DICOM.

Ejecución del servidor

Ejecución directa

uv run server.py

A través de Claude

Una vez instalado a través de MCP, el servidor será administrado automáticamente por Claude cuando sea necesario.

El servidor se iniciará en 0.0.0.0:8080 de forma predeterminada.

Configuración del nodo

El servidor utiliza un archivo nodes.yaml para almacenar las configuraciones de los nodos DICOM. Esto permite:

1. Listar todos los nodos DICOM configurados

2. Realice operaciones C-ECHO utilizando nombres de nodo en lugar de títulos AE, IP y puertos explícitos

3. Utilice diferentes títulos de AE locales para las operaciones C-ECHO

Formato nodes.yaml

nodes:
  # Example node configuration
  main_pacs:
    ae_title: DESTINATION
    ip: 192.168.1.100
    port: 104
    description: "Main hospital PACS system"

local_ae_titles:
  - name: default
    ae_title: MCP_DICOM
    description: "Default AE title for MCP DICOM server"
  
  - name: pacs_gateway
    ae_title: PACS_GATEWAY
    description: "PACS Gateway AE title"

Solución de problemas

Si encuentra el error "spawn uv ENOENT", generalmente significa una de las siguientes cosas:

1. UV no está instalado o no está en su PATH

2. El cliente MCP no puede encontrar el ejecutable de Python

Soluciones:

1. Asegúrese de que el sistema UV esté correctamente instalado y en su PATH:

   which uv  # Should show the path to UV

2. Asegúrese de estar utilizando un entorno Python que sea accesible para el sistema:

   • Si utiliza un entorno virtual, asegúrese de que esté activado

   • Comprueba que Python está en tu PATH

3. Intente ejecutar el servidor con la ruta UV explícita:

   /full/path/to/uv run server.py

4. Agregue más depuración verificando la salida de stderr en los registros

Uso

El servidor proporciona varias herramientas DICOM que se pueden utilizar a través de la interfaz MCP:

Lista de nodos DICOM

Enumere todos los nodos DICOM configurados desde el archivo nodes.yaml:

list_dicom_nodes()

C-ECHO por nombre de nodo

Realice una operación C-ECHO utilizando un nombre de nodo de la configuración:

dicom_cecho_by_name(node_name="main_pacs", local_ae_name="default")

C-ECHO directo

Realizar una operación C-ECHO con parámetros explícitos:

dicom_cecho(remote_ae_title="REMOTE_AE", ip="192.168.1.100", port=104, local_ae_title="MCP_DICOM")