LLM Jukebox

Servidor MCP LLM Jukebox

Um servidor Model Context Protocol (MCP) que permite que LLMs pesquisem, baixem e reproduzam música do YouTube.

Recursos

• Pesquisa de Música do YouTube: Encontre vídeos musicais por artista, título da música, álbum ou qualquer consulta de pesquisa
• Download de Áudio: Baixe e converta vídeos do YouTube em arquivos MP3 de alta qualidade
• Reprodução de Áudio: O modelo pode iniciar e parar músicas
• Operações Assíncronas: Downloads e pesquisas não bloqueantes com rastreamento de progresso
• Registro de Logs: Registro em nível de depuração para arquivo e stderr

Instalação

• Obtenha os Arquivos: Clone o repositório ou baixe e extraia o zip
• Obtenha o FFMPEG: Certifique-se de ter o ffmpeg. No Windows, abra um terminal e digite winget install ffmpeg, no Ubuntu ou Debian faça sudo apt install ffmpeg
• Carregue um Modelo Capaz de Usar Ferramentas: Certifique-se de ter um modelo treinado para lidar com ferramentas adequadamente. Qwen 3 e Gemma 3 são boas opções.
• Crie a Entrada JSON: No LM Studio, clique no modo Desenvolvedor, depois em Programa, Ferramentas e Integrações, na seta ao lado do botão Instalar, e em Editar mcp.json. Adicione a entrada abaixo em 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"
  }
}

Certifique-se de alterar os caminhos para corresponder aos caminhos onde o repositório está e para onde você deseja que os downloads sejam salvos.

Se você não tiver outras entradas, o JSON completo deve ficar mais ou menos assim:

{
  "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"
      }
    }
  }
}

Clique no botão Salvar ou pressione Ctrl+S. Se funcionar, você deverá conseguir ajustar o controle deslizante para ativar o llm-jukebox.

Agora você pode pedir ao LLM para pegar uma música para você!

Considerações Legais

Esta ferramenta é destinada ao uso pessoal com conteúdo que você tem o direito de baixar. Os usuários são responsáveis por cumprir:

• os Termos de Serviço do YouTube
• as leis de direitos autorais locais
• os direitos dos criadores de conteúdo

Sempre respeite a propriedade intelectual e considere apoiar os artistas por meio de canais oficiais.

Créditos

Ferramenta de reprodução adaptada de https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp (Licença MIT)