Servidor MCP

Controlar TurboDL desde un asistente de IA (Claude Code, Claude Desktop…).

turbodl-mcp es un servidor Model Context Protocol por stdio. Las descargas se ejecutan en su proceso, con el motor de TurboDL.

Configuración del cliente

Claude Code:

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

Claude Desktop (claude_desktop_config.json) o cualquier cliente compatible:

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

Sin --profile, se usa el perfil por defecto (y se crea si falta).

Herramientas

Herramienta	Parámetros	Resultado
`download`	`url`, `profile?`, `filename?`	Inicia en segundo plano; devuelve el `id` y un primer estado
`status`	`id`	Estado, %, bytes, velocidad, tiempo restante, hilos, ruta o error
`list`	—	Todas las descargas del servidor
`pause`	`id`	Pausa (se conserva el progreso)
`resume`	`id`	Reanuda donde se detuvo
`cancel`	`id`	Cancela y borra el archivo parcial
`wait`	`id`, `timeout_secs?` (60, máx. 600)	Espera el final y devuelve el estado, sin sondear en bucle
`detect_category`	`name_or_url`	Categoría según el perfil
`stats`	`period?` (`7d`, `30d`, `12m`, `all`)	Cifras, desgloses y observaciones (en inglés)

Seguridad

Los archivos van siempre a la carpeta del perfil (o a su subcarpeta de categoría).
filename debe ser un nombre simple: se rechazan ../x o una ruta.
Solo se aceptan URL http(s).
Las respuestas no contienen ningún secreto.