hybrid server

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

Servidor DICOM MCP

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

Prerrequisitos

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.

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:

Listar todos los nodos DICOM configurados
Realice operaciones C-ECHO utilizando nombres de nodo en lugar de títulos AE, IP y puertos explícitos
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:

UV no está instalado o no está en su PATH
El cliente MCP no puede encontrar el ejecutable de Python

Soluciones:

Asegúrese de que el sistema UV esté correctamente instalado y en su PATH:
which uv # Should show the path to UV
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
Intente ejecutar el servidor con la ruta UV explícita:
/full/path/to/uv run server.py
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")

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de pruebas de conectividad que permite operaciones de red DICOM (como C-ECHO) a través del Protocolo de Contexto Modelo de Claude, con soporte para la gestión de configuración de nodos.

Related Resources

Reddit Discussion about this server

DICOM MCP Server