MCP yt-dlp Server

Un servidor del Model Context Protocol (MCP) para descargar vídeos y transmisiones usando yt-dlp. Este servidor permite que los clientes compatibles con MCP (como Claude Desktop) descarguen vídeos de YouTube y de más de 1000 sitios compatibles, extraigan audio, descarguen subtítulos y capturen transmisiones en vivo.

Créditos

Este proyecto se basa en el increíble trabajo del equipo de yt-dlp. yt-dlp es un descargador de audio/vídeo de línea de comandos repleto de funciones compatible con miles de sitios. Para obtener más información sobre yt-dlp, visita su repositorio de GitHub o su wiki.

Related MCP server: MCP YouTube Downloader

Funciones

• Descarga de vídeos: Descarga vídeos de YouTube y de más de 1000 sitios compatibles

• Descarga de streams: Captura transmisiones en vivo y streams HLS/m3u8

• Información del vídeo: Obtiene metadatos sin descargar

• Listado de formatos: Enumera todos los formatos disponibles para un vídeo

• Búsqueda: Busca vídeos directamente mediante los extractores de yt-dlp

• Extracción de audio: Descarga solo audio con conversión de formato (MP3, M4A, WAV, FLAC)

• Subtítulos: Descarga subtítulos en varios idiomas

• Compatibilidad con listas de reproducción: Descarga listas de reproducción completas o parciales

Requisitos previos

• Node.js 18+

• yt-dlp instalado y disponible en el mismo directorio que el servidor (o en el PATH)

Guía de instalación

Paso 1: Instalar Node.js

Descarga e instala Node.js 18+ desde nodejs.org.

Verifica la instalación:

node --version
npm --version

Paso 2: Descargar yt-dlp (Método sencillo)

Proporcionamos scripts de configuración que descargan automáticamente la última versión de yt-dlp al directorio correcto.

Windows: Haz doble clic en setup.bat o ejecútalo en el Símbolo del sistema:

setup.bat

Linux / macOS:

chmod +x setup.sh
./setup.sh

El script:

• Detectará tu sistema operativo

• Descargará el binario más reciente de yt-dlp

• Lo colocará en el mismo directorio que el servidor MCP

• Verificará la instalación

Paso 2 alternativo: Descarga manual

Si prefieres instalar yt-dlp manualmente:

Windows:

1. Descarga yt-dlp.exe desde las últimas versiones

2. Coloca yt-dlp.exe en el mismo directorio que el servidor MCP

macOS:

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

Linux:

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Python (todas las plataformas):

pip install yt-dlp

Para más opciones de instalación, consulta la guía de instalación de yt-dlp.

Paso 3: Clonar el repositorio

git clone https://github.com/timyee22/yt-dlp-MCP.git
cd yt-dlp-MCP

Paso 4: Instalar las dependencias

npm install

Paso 5: Configurar el cliente MCP

Añade el servidor a la configuración de tu cliente MCP:

Claude Desktop (Windows): Edita %APPDATA%\Claude\settings.json:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["C:\\path\\to\\yt-dlp-MCP\\index.js"]
    }
  }
}

Claude Desktop (macOS/Linux): Edita ~/Library/Application Support/Claude/settings.json (macOS) o la ruta de configuración correspondiente:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["/path/to/yt-dlp-MCP/index.js"]
    }
  }
}

Importante: Asegúrate de que yt-dlp.exe (Windows) o yt-dlp (macOS/Linux) esté:

• En el mismo directorio que index.js

• O disponible en el PATH de tu sistema

Paso 6: Reiniciar Claude Desktop

Después de añadir la configuración, reinicia Claude Desktop para cargar el nuevo servidor MCP.

Uso

Una vez configurado, puedes pedirle a Claude que:

• "Descargue este vídeo de YouTube: [URL]"

• "Descargue solo el audio de este vídeo como MP3"

• "Obtenga información sobre este vídeo sin descargarlo"

• "Enumere todos los formatos disponibles para este vídeo"

• "Busque vídeos sobre [tema] en YouTube"

• "Descargue los subtítulos de este vídeo en español"

Herramientas disponibles

download_video

Descarga vídeos desde URL.

Parámetros:

• url (obligatorio): URL del vídeo

• outputDir: Directorio de salida (predeterminado: directorio actual)

• format: Selección de formato (predeterminado: "best")

• quality: Calidad del vídeo (p. ej., "1080p", "720p")

• audioOnly: Descargar solo audio (predeterminado: false)

• audioFormat: Formato de audio para la extracción (predeterminado: "mp3")

• subtitles: Descargar subtítulos (predeterminado: false)

• subtitleLangs: Idiomas de los subtítulos (predeterminado: "en")

• playlistStart/playlistEnd: Rango de la lista de reproducción

• noPlaylist: Descargar solo un vídeo (predeterminado: false)

• additionalArgs: Argumentos adicionales de yt-dlp

Ejemplos:

Descargar un vídeo de YouTube:

{
  "url": "https://www.youtube.com/watch?v=...",
  "quality": "1080p",
  "subtitles": true
}

Descargar solo el audio:

{
  "url": "https://www.youtube.com/watch?v=...",
  "audioOnly": true,
  "audioFormat": "mp3"
}

download_stream

Descarga transmisiones en vivo o streams HLS.

Parámetros:

• url (obligatorio): URL del stream

• outputDir: Directorio de salida

• duration: Duración de captura en segundos

• format: Preferencia de formato (predeterminado: "best")

• outputName: Nombre de archivo de salida personalizado

• hlsUseMpegts: Usar MPEG-TS para HLS (predeterminado: true)

• additionalArgs: Argumentos adicionales

get_video_info

Obtiene los metadatos del vídeo sin descargarlo.

Parámetros:

• url (obligatorio): URL del vídeo

• flatPlaylist: Información más rápida de la lista de reproducción (predeterminado: false)

list_formats

Enumera todos los formatos disponibles para una URL.

Parámetros:

• url (obligatorio): URL del vídeo

search_videos

Busca vídeos mediante los extractores de yt-dlp.

Parámetros:

• query (obligatorio): Consulta de búsqueda

• extractor: Prefijo del extractor de búsqueda (predeterminado: "ytsearch10")

• getInfo: Obtener información detallada (predeterminado: true)

Ejemplo:

{
  "query": "programming tutorials",
  "extractor": "ytsearch5"
}

update_yt_dlp

Actualiza yt-dlp a la última versión.

Sitios compatibles

yt-dlp es compatible con más de 1000 sitios, entre ellos:

• YouTube

• Twitch

• Vimeo

• Twitter/X

• Instagram

• TikTok

• Facebook

• SoundCloud

• Y muchos más...

Consulta los sitios compatibles de yt-dlp para ver la lista completa.

Solución de problemas

yt-dlp no encontrado

• Asegúrate de que yt-dlp.exe (Windows) o yt-dlp (macOS/Linux) esté en el mismo directorio que el servidor o en tu PATH

• En Windows, es posible que debas añadir el directorio a la variable de entorno PATH

Errores de Node.js

• Asegúrate de tener Node.js 18+ instalado: node --version

• Asegúrate de que las dependencias estén instaladas: npm install

Formato no disponible

• Es posible que algunos vídeos no tengan el formato solicitado. Usa list_formats para ver las opciones disponibles

• YouTube puede restringir algunos formatos. Prueba con diferentes ajustes de calidad

Licencia

Unlicense

Agradecimientos

• yt-dlp: el potente descargador de vídeos que hace posible esto

• Model Context Protocol: el protocolo que permite a los asistentes de IA usar herramientas