金大哥 - llm-jukebox MCP 详情

article

README

🚀 LLM Jukebox MCP Server

LLM Jukebox MCP Server 是一个基于模型上下文协议（MCP）的服务器，它能让大语言模型（LLMs）在 YouTube 上搜索、下载并播放音乐。

✨ 主要特性

YouTube 音乐搜索：可通过艺术家、歌曲标题、专辑或任意搜索关键词查找音乐视频。
音频下载：能将 YouTube 视频下载并转换为高质量的 MP3 文件。
音频播放：模型可以控制歌曲的播放和停止。
异步操作：支持非阻塞式的下载和搜索，并能跟踪进度。
日志记录：支持将调试级别的日志记录到文件和标准错误输出。

📦 安装指南

获取文件：克隆仓库，或者下载并解压 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",
    "c:/path/to/llm-jukebox/server.py"
  ],
  "env": {
    "DOWNLOAD_PATH": "c:/path/to/downloads"
  }
}

请确保将路径修改为仓库所在的实际路径以及你希望下载文件存放的路径。

如果你没有其他条目，完整的 JSON 文件应该类似于以下内容：

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

点击“保存”按钮或按下 Ctrl + S。如果操作成功，你应该能够通过滑动开关启用 llm-jukebox。

现在，你就可以要求大语言模型为你抓取歌曲了！

📚 详细文档

法律注意事项

本工具仅供个人使用，且仅用于下载你有权限下载的内容。用户有责任遵守以下规定：

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

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

致谢

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

llm-jukebox