Llm Jukebox

🚀 LLM Jukebox MCP Server

このサーバーは、Model Context Protocol (MCP) を用いて、大規模言語モデル (LLM) がYouTubeの音楽を検索、ダウンロード、再生できるようにするものです。

✨ 主な機能

• YouTube音楽検索：アーティスト、曲名、アルバム名などをキーワードに音楽ビデオを検索できます。
• 音声ダウンロード：YouTubeのビデオを高品質なMP3ファイルに変換してダウンロードできます。
• 音声再生：モデルから曲の再生と停止を制御できます。
• 非同期操作：進行状況を追跡しながら、非ブロッキングでダウンロードと検索を行えます。
• ロギング：デバッグレベルのログをファイルと標準エラー出力に記録します。

📦 インストール

• ファイルの取得：リポジトリをクローンするか、zipファイルをダウンロードして展開します。
• FFMPEGのインストール：ffmpegがインストールされていることを確認してください。Windowsの場合はターミナルを開き、winget install ffmpeg と入力します。UbuntuまたはDebianの場合は sudo apt install ffmpeg を実行します。
• ツール対応モデルの読み込み：ツールを適切に扱うように学習されたモデルを用意してください。Qwen 3 やGemma 3 は適した選択肢です。
• JSONエントリの作成：LM Studioで、開発者モードをクリックし、次に「Program」「Tools and Integrations」を選択し、インストールボタンの横にある矢印をクリックして「Edit 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"
      }
    }
  }
}

「Save」ボタンをクリックするか、Ctrl+S を押します。正常に動作すれば、スライダーを操作して llm-jukebox を有効にできます。

これで、LLMに曲を取得するように依頼できます！

🔖 法的な考慮事項

このツールは、ダウンロード権を持つコンテンツの個人使用を目的としています。ユーザーは以下の事項を遵守する責任があります。

• YouTubeの利用規約
• 現地の著作権法
• コンテンツ作成者の権利

常に知的財産権を尊重し、公式チャンネルを通じてアーティストをサポートすることを検討してください。

📄 ライセンス

再生ツールは https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp から適応されています（MITライセンス）。