Llm Jukebox

🚀 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 許可證）。