DICOM API MCP Server

Macht DICOM-Operationen (Digital Imaging and Communications in Medicine) als Werkzeuge für KI-Agenten verfügbar.

GitHub

Dokumentation

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