LLM Jukebox MCP Server

这是一个模型上下文协议（MCP）服务器，使大型语言模型（LLMs）能够搜索、下载并播放YouTube音乐。

功能

• YouTube 音乐搜索：通过艺术家、歌曲标题、专辑或任何搜索查询来查找音乐视频
• 音频下载：下载并转换YouTube视频为高质量MP3文件
• 音频播放：模型可以开始和停止歌曲
• 异步操作：非阻塞下载和搜索，并带有进度跟踪
• 日志记录：调试级别日志记录到文件和stderr

安装

• 获取文件：克隆仓库或下载并解压zip文件
• 安装FFMPEG：确保已安装ffmpeg。在Windows中打开终端并键入winget install ffmpeg，在Ubuntu或Debian中执行sudo apt install ffmpeg
• 加载支持工具的模型：确保您有一个经过训练以正确处理工具的模型。Qwen 3 和 Gemma 3 是不错的选择。
• 创建JSON条目：在LM Studio中，点击开发者模式，然后选择程序、工具和集成，点击安装按钮旁边的箭头，编辑mcp.json。在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"
  }
}

请确保更改路径以适应您的仓库位置以及您希望下载文件的位置。

如果您没有其他条目，完整的JSON应如下所示：

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

点击保存按钮或按Ctrl+S。如果一切正常，您应该能够设置滑块以启用llm-jukebox。

现在您可以要求LLM为您抓取一首歌了！

法律注意事项

此工具旨在用于个人使用，并且内容必须是您有权下载的内容。用户需负责遵守：

• YouTube的服务条款
• 当地版权法
• 内容创作者的权利

始终尊重知识产权，并考虑通过官方渠道支持艺术家。

致谢

播放工具改编自https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp（MIT许可）