Dannex Download Manager
  1. Início
  2. Ajuda
  3. Assistentes de IA (MCP)

Assistentes de IA (MCP)

O DDM inclui um servidor MCP, dannexdownloadmanager-mcp, para que um assistente de IA compatível com MCP (Claude Desktop, Claude Code, Cursor, VS Code e outros) possa trabalhar com as transferências enquanto o DDM está em execução. Basta pedir o que pretende, com as suas próprias palavras:

  • «O que está o DDM a transferir neste momento e quanto tempo falta?»
  • «Transferir https://example.com/big.iso para D:\ISOs esta noite, mas não iniciar ainda.»
  • "Interromper tudo o que está a ser transferido."
  • «Remover da lista as transferências concluídas, mas manter os ficheiros.»

O assistente inicia o próprio servidor; só precisa de indicar ao assistente onde ele está, uma vez. O servidor passa cada pedido à aplicação através da sua API de automação, apenas neste computador.

O que o assistente pode fazer

Ferramenta O que faz
list_downloads Apresenta as transferências por ordem decrescente de data: ficheiro, endereço, pasta, estado, tamanho, progresso e velocidade. Pode apresentar apenas as transferências com um determinado estado (Em fila, A transferir, Parado, Concluído, Erro) ou apenas os nomes e endereços que contenham determinado texto.
add_download Adiciona um endereço http, https, ftp ou ftps e inicia a transferência ou coloca-a apenas em fila. Pode especificar a pasta e o nome do ficheiro. Uma ligação magnet abre Adicionar torrent no DDM, para que possa escolher os ficheiros.
pause_downloads Interrompe as transferências em curso.
resume_downloads Inicia ou retoma as transferências paradas, em fila ou com erro.
remove_downloads Remove as transferências da lista e mantém os respetivos ficheiros ou, se lhe for pedido, também elimina os ficheiros. É necessário interromper primeiro uma transferência em curso.
start_queue Inicia a fila de transferências principal.

O assistente não pode alterar as opções do DDM, ver o navegador nem ativar a API de automação por iniciativa própria.

Configurar

1. Ligar a API de automação

Para listar e controlar as transferências, é necessária a API de automação do DDM, que está desligada até a ativar. Com o DDM em execução, execute este comando uma vez (a API permanece ligada):

dannexdownloadmanager-cli api on

dannexdownloadmanager-cli api offdesliga-a novamente. Sem a API, o assistente pode continuar a adicionar transferências, tal como através da linha de comandos do DDM.

2. Localizar o servidor

dannexdownloadmanager-mcpencontra-se junto à aplicação:

Instalação Servidor
Windows, apenas para si (predefinição do instalador) %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, para todos C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, um zip ou cópia portátil dannexdownloadmanager-mcp.exena pasta da aplicação
macOS /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp
Linux, pacote .deb ou .rpm /usr/bin/dannexdownloadmanager-mcp
Linux, o .tar.gz dannexdownloadmanager-mcpna sua pasta (o AppImage não o expõe: use o .tar.gz)

O servidor de uma cópia portátil encontra automaticamente o DDM dessa cópia, a partir da respetiva pasta.

3. Diga ao seu assistente

Claude Desktop: Definições → Programador → Editar Configuração abre claude_desktop_config.json. Adicione o servidor e, em seguida, reinicie o Claude Desktop:

{
  "mcpServers": {
    "dannexdownloadmanager": {
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Claude Code:

claude mcp add dannexdownloadmanager -- "C:\Users\you\AppData\Local\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe"

Cursor: a mesma entrada mcpServers que a do Claude Desktop, em ~/.cursor/mcp.json (ou adicione-a nas definições MCP do Cursor).

VS Code: em .vscode/mcp.json, ou MCP: Adicionar Servidor na paleta de comandos:

{
  "servers": {
    "dannexdownloadmanager": {
      "type": "stdio",
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Use o caminho do passo 2 (em JSON, cada \ é escrito \\). Outros assistentes usam o mesmo: um comando para iniciar, sem argumentos.

Privacidade

O próprio DDM continua a não enviar nada para lado nenhum: o servidor comunica apenas com o DDM neste computador, através do canal local protegido por token. No entanto, o que o assistente lê é enviado para o serviço de IA do próprio assistente: quando este lista as suas transferências, os nomes dos ficheiros, os endereços e as pastas são enviados para esse serviço, ao abrigo dos respetivos termos de privacidade. Desative a API de automatização ou remova o servidor do assistente se não quiser que isso aconteça.

Quando não funciona

O assistente diz O que fazer
Dannex Download Manager não está em execução Inicie o DDM. O servidor não o pode iniciar por si.
A API de automação está desativada Execute dannexdownloadmanager-cli api on com o DDM em execução.
O DDM não respondeu a tempo Uma janela no DDM pode estar à sua espera (uma pergunta, Adicionar torrent); responda e pergunte novamente.
O DDM recusou o pedido O ficheiro de canal do DDM é de um início anterior; reinicie o DDM.
As ferramentas não aparecem de todo Verifique o caminho nas definições do assistente e reinicie o assistente. Iniciado manualmente, dannexdownloadmanager-mcp --help diz o que é.

Gratuito, de código aberto, sem anúncios, sem período de avaliação.

Transferir Dannex Download Manager