LLM Jukebox

Servidor MCP de LLM Jukebox

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM buscar, descargar y reproducir música de YouTube.

Características

• Búsqueda de Música de YouTube: Encuentra videos musicales por artista, título de canción, álbum o cualquier consulta de búsqueda
• Descarga de Audio: Descarga y convierte videos de YouTube a archivos MP3 de alta calidad
• Reproducción de Audio: El modelo puede iniciar y detener canciones
• Operaciones Asíncronas: Descargas y búsquedas no bloqueantes con seguimiento de progreso
• Registro: Registro a nivel de depuración en archivo y stderr

Instalación

• Obtén los Archivos: Clona el repositorio o descarga y extrae el zip
• Obtén FFMPEG: Asegúrate de tener ffmpeg. En Windows abre una terminal y escribe winget install ffmpeg, en Ubuntu o Debian ejecuta sudo apt install ffmpeg
• Carga un Modelo Capaz de Usar Herramientas: Asegúrate de tener un modelo entrenado para manejar herramientas correctamente. Qwen 3 y Gemma 3 son buenas opciones.
• Crea la Entrada JSON: En LM Studio, haz clic en Modo Desarrollador, luego Programa, Herramientas e Integraciones, luego la flecha junto al botón Instalar, y Editar mcp.json. Agrega la entrada siguiente bajo mcpServers:

"llm-jukebox": {
  "command": "uv",
  "args": [
	"run",
	"--with",
	"fastmcp",
	"--with",
	"yt-dlp",
	"--with",
	"tinydb",
	"--with",
	"pygame",
	"fastmcp",
	"run",
	"c:/path/to/llm-jukebox/server.py"
  ],
  "env": {
	"DOWNLOAD_PATH": "c:/path/to/downloads"
  }
}

Asegúrate de cambiar las rutas para que coincidan con las rutas donde está el repositorio y donde quieres que se guarden las descargas.

Si no tienes otras entradas, el JSON completo debería verse así:

{
  "mcpServers": {
    "llm-jukebox": {
      "command": "uv",
      "args": [
		"run",
		"--with",
		"fastmcp",
		"--with",
		"yt-dlp",
		"--with",
		"tinydb",
		"--with",
		"pygame",
		"fastmcp",
		"run",
        "c:/users/user/llm-jukebox/server.py"
      ],
      "env": {
        "DOWNLOAD_PATH": "c:/users/user/downloads"
      }
    }
  }
}

Haz clic en el botón Guardar o presiona Ctrl+S. Si funciona, deberías poder ajustar el control deslizante para activar llm-jukebox.

Ahora puedes pedirle al LLM que consiga una canción para ti.

Consideraciones Legales

Esta herramienta está destinada al uso personal con contenido que tienes derecho a descargar. Los usuarios son responsables de cumplir con:

• Los Términos de Servicio de YouTube
• Las leyes de derechos de autor locales
• Los derechos de los creadores de contenido

Respeta siempre la propiedad intelectual y considera apoyar a los artistas a través de canales oficiales.

Crédito

Herramienta de reproducción adaptada de https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp (Licencia MIT)