DICOM API

Expõe operações DICOM (Digital Imaging and Communications in Medicine) como ferramentas para agentes de IA.

GitHubExperimente este MCPPatrocinado

Documentação

Este é um servidor MCP (Model Context Protocol) que expõe operações DICOM como ferramentas para agentes de IA.

Características

  • Busca de estudos DICOM no PACS
  • Busca de séries dentro de estudos
  • Consulta de metadados de instâncias
  • Movimentação de entidades DICOM para o servidor local
  • Obtenção de dados de pixels de instâncias locais

Instalação

pip install -e .

Configuração

  1. Ajuste a variável DICOM_SERVER_BASE_URL no arquivo principal conforme sua configuração:

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

  2. Configure seu 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

O servidor expõe as seguintes ferramentas:

query_studies

Busca estudos no PACS

  • patient_id: ID do paciente
  • study_date: Data do estudo (YYYYMMDD)
  • accession_number: Número de acesso
  • patient_name: Nome do paciente
  • additional_filters: Filtros adicionais

query_series

Busca séries dentro de um estudo

  • study_instance_uid: UID do estudo (obrigatório)
  • additional_filters: Filtros adicionais

query_instances

Busca metadados de instâncias em uma série

  • study_instance_uid: UID do estudo (obrigatório)
  • series_instance_uid: UID da série (obrigatório)
  • fields_to_retrieve: Campos específicos a recuperar

move_dicom_entity_to_local_server

Move entidades DICOM para o servidor local

  • study_instance_uid: UID do estudo (obrigatório)
  • series_instance_uid: UID da série (opcional)
  • sop_instance_uid: UID da instância (opcional)

get_local_instance_pixel_data

Obtém dados de pixels de instâncias locais

  • sop_instance_uid: UID da instância (obrigatório)

Desenvolvimento

Para desenvolvimento:

pip install -e ".[dev]"

Licença