Dannex Download Manager
  1. Home
  2. Guida
  3. Assistenti AI (MCP)

Assistenti AI (MCP)

DDM include un server MCP, dannexdownloadmanager-mcp, così un assistente AI che supporta MCP (Claude Desktop, Claude Code, Cursor, VS Code e altri) può interagire con i download mentre DDM è in esecuzione. Puoi chiedergli, con parole tue:

  • "Cosa sta scaricando DDM in questo momento e quanto tempo manca?"
  • "Scarica https://example.com/big.iso in D:\ISOs stanotte, ma non avviarlo ancora."
  • "Metti in pausa tutti i download in corso."
  • "Rimuovi i download completati dall'elenco ma conserva i file."

L'assistente avvia il server da solo; devi solo indicargli dove si trova, una volta sola. Il server inoltra ogni richiesta all'app tramite la sua API di automazione, solo su questo computer.

Cosa può fare l'assistente

Strumento Cosa fa
list_downloads Elenca i tuoi download, dai più recenti ai meno recenti: file, indirizzo, cartella, stato, dimensione, quantità scaricata e velocità. Può elencare solo i download con un determinato stato (In coda, Download in corso, Interrotto, Completato, Errore) oppure solo quelli con nomi e indirizzi che contengono un certo testo.
add_download Aggiunge un indirizzo http, https, ftp o ftps e avvia il download, oppure lo mette solo in coda. Può specificare la cartella e il nome del file da usare. Un link magnet apre Aggiungi torrent in DDM, così puoi scegliere i file.
pause_downloads Mette in pausa i download in corso.
resume_downloads Avvia o riprende i download interrotti, in coda o non riusciti.
remove_downloads Rimuove i download dall'elenco conservando i relativi file, oppure elimina anche i file se richiesto. Prima, un download in corso deve essere messo in pausa.
start_queue Avvia la coda di download principale.

L'assistente non può modificare le opzioni di DDM, vedere il browser o attivare da solo l'API di automazione.

Configurazione

1. Attiva l'API di automazione

Per elencare e gestire i download serve l'API di automazione di DDM, disattivata finché non la attivi. Con DDM in esecuzione, esegui questo comando una volta (resterà attiva):

dannexdownloadmanager-cli api on

dannexdownloadmanager-cli api offla disattiva. Senza l'API, l'assistente può comunque aggiungere download, come dalla riga di comando di DDM.

2. Trova il server

dannexdownloadmanager-mcpsi trova accanto all'app:

Hai installato Il server
Windows, solo per te (impostazione predefinita del programma di installazione) %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, per tutti C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, uno zip o una copia portatile dannexdownloadmanager-mcp.exenella cartella dell'app
macOS /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp
Linux, il .deb o .rpm /usr/bin/dannexdownloadmanager-mcp
Linux, il .tar.gz dannexdownloadmanager-mcpnella sua cartella (l'AppImage non lo rende accessibile: usa il .tar.gz)

Il server di una copia portatile trova da solo DDM, partendo dalla propria cartella.

3. Indica al tuo assistente

Claude Desktop: Impostazioni → Sviluppatore → Modifica configurazione apre claude_desktop_config.json. Aggiungi il server, poi riavvia 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: la stessa voce mcpServers di Claude Desktop, in ~/.cursor/mcp.json (o aggiungila nelle impostazioni MCP di Cursor).

VS Code: in .vscode/mcp.json, oppure MCP: Aggiungi server nel riquadro comandi:

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

Usa il percorso del passaggio 2 (in JSON, ogni \ è scritto \\). Altri assistenti richiedono la stessa cosa: un comando per avviare, senza argomenti.

Privacy

DDM continua a non inviare nulla da nessuna parte: il server comunica solo con DDM su questo computer, tramite il canale locale protetto da token. Ma ciò che l'assistente legge, lo passa al proprio servizio AI: quando elenca i tuoi download, i nomi dei file, indirizzi e cartelle vanno a quel servizio, secondo i termini di privacy di quel servizio. Disattiva l'API di automazione, o rimuovi il server dall'assistente, quando non lo desideri.

Quando non funziona

L'assistente dice Cosa fare
Dannex Download Manager non è in esecuzione Avvia DDM. Il server non può avviarlo per te.
L'API di automazione è disattivata Esegui dannexdownloadmanager-cli api on con DDM in esecuzione.
DDM non ha risposto in tempo Una finestra in DDM potrebbe essere in attesa di una tua risposta (una domanda, Aggiungi torrent); rispondi e chiedi di nuovo.
DDM ha rifiutato la richiesta Il file del canale di DDM proviene da un avvio precedente; riavvia DDM.
Gli strumenti non vengono visualizzati affatto Controlla il percorso nelle impostazioni dell'assistente e riavvia l'assistente. Avviato manualmente, dannexdownloadmanager-mcp --help dice cos'è.

Gratuito, open source, senza pubblicità, senza periodo di prova.

Scarica Dannex Download Manager