Serveur MCP

Piloter TurboDL depuis un assistant IA (Claude Code, Claude Desktop…).

turbodl-mcp est un serveur Model Context Protocol en stdio. Les téléchargements tournent dans son processus, avec le moteur de TurboDL.

Configuration du client

Claude Code :

claude mcp add turbodl -- turbodl-mcp --profile ~/.config/turbodl/default.profile.json

Claude Desktop (claude_desktop_config.json) ou tout client compatible :

{
  "mcpServers": {
    "turbodl": {
      "command": "turbodl-mcp",
      "args": ["--profile", "C:/Users/moi/AppData/Roaming/turbodl/default.profile.json"]
    }
  }
}

Sans --profile, le profil par défaut est utilisé (et créé s'il manque).

Outils

Outil	Paramètres	Résultat
`download`	`url`, `profile?`, `filename?`	Démarre en arrière-plan ; renvoie l'`id` et un premier état
`status`	`id`	État, %, octets, vitesse, durée estimée, threads, chemin ou erreur
`list`	—	Tous les téléchargements du serveur
`pause`	`id`	Met en pause (progression conservée)
`resume`	`id`	Reprend là où il s'est arrêté
`cancel`	`id`	Annule et efface le fichier partiel
`wait`	`id`, `timeout_secs?` (60, max 600)	Attend la fin et renvoie l'état, sans interroger en boucle
`detect_category`	`name_or_url`	Catégorie selon le profil
`stats`	`period?` (`7d`, `30d`, `12m`, `all`)	Chiffres, répartitions et constats (en anglais)

Sécurité

Les fichiers vont toujours dans le dossier du profil (ou son sous-dossier de catégorie).
filename doit être un simple nom : ../x ou un chemin est refusé.
Seules les URL http(s) sont acceptées.
Les réponses ne contiennent aucun secret.