DICOM API

Exposes DICOM (Digital Imaging and Communications in Medicine) operations as tools for AI agents.

GitHub

Este es un servidor MCP (Model Context Protocol) que expone operaciones DICOM como herramientas para agentes de IA.

Características

  • Búsqueda de estudios DICOM en PACS
  • Búsqueda de series dentro de estudios
  • Consulta de metadatos de instancias
  • Movimiento de entidades DICOM al servidor local
  • Obtención de datos de píxeles de instancias locales

Instalación

pip install -e .

Configuración

  1. Ajusta la variable DICOM_SERVER_BASE_URL en el archivo principal según tu configuración:

    DICOM_SERVER_BASE_URL = "http://tu-servidor-dicom:puerto"

  2. Configura tu cliente MCP para usar este servidor:

    {
  "mcpServers": {
    "dicom-tools": {
      "command": "python",
      "args": ["/ruta/a/dicom_mcp_server.py"],
      "env": {
        "DICOM_SERVER_URL": "http://localhost:8000"
      }
    }
  }
}

Uso

El servidor expone las siguientes herramientas:

query_studies

Busca estudios en el PACS

  • patient_id: ID del paciente
  • study_date: Fecha del estudio (YYYYMMDD)
  • accession_number: Número de acceso
  • patient_name: Nombre del paciente
  • additional_filters: Filtros adicionales

query_series

Busca series dentro de un estudio

  • study_instance_uid: UID del estudio (requerido)
  • additional_filters: Filtros adicionales

query_instances

Busca metadatos de instancias en una serie

  • study_instance_uid: UID del estudio (requerido)
  • series_instance_uid: UID de la serie (requerido)
  • fields_to_retrieve: Campos específicos a recuperar

move_dicom_entity_to_local_server

Mueve entidades DICOM al servidor local

  • study_instance_uid: UID del estudio (requerido)
  • series_instance_uid: UID de la serie (opcional)
  • sop_instance_uid: UID de la instancia (opcional)

get_local_instance_pixel_data

Obtiene datos de píxeles de instancias locales

  • sop_instance_uid: UID de la instancia (requerido)

Desarrollo

Para desarrollo:

pip install -e ".[dev]"

Licencia

Related Servers