Tidal MCP

🚀 TIDAL MCP: My Custom Picks 🌟🎧

Modlによってホストされており、Modlチームによるコミットや変更は互換性を確保するためのものです。

ほとんどの音楽プラットフォームは、「毎日のおすすめ」「人気アーティスト」「新着楽曲」などの推薦機能を提供しています。しかし、最新のシステムを搭載しているにもかかわらず、それらの推薦はしばしば「集約的」すぎる印象を与えます。私は、よりカスタマイズ可能で状況に応じた推薦を望んでいました。

TIDAL MCPを使えば、以下のようなリクエストが可能です。

「過去10曲のお気に入りを元に、似たような曲を探してください。ただし、近年の曲のみを対象とします。」

「このプレイリストの曲に似た、よりゆっくりでアコースティックな曲を探してください。」

LLMは、あなたの入力を元に結果をフィルタリングし、TIDALのAPIを使って似たような曲を探し、直接あなたのアカウントに新しいプレイリストを作成します。

✨ 主な機能

• 🌟 音楽推薦：あなたの聴き歴とカスタム条件に基づいた、パーソナライズされた曲の推薦を受け取ります。
• ၊၊||၊ プレイリスト管理：TIDALのプレイリストを作成、閲覧、管理することができます。

🚀 クイックスタート

前提条件

• Python 3.10以上
• uv (Pythonパッケージマネージャー)
• TIDALのサブスクリプション

📦 インストール

1. このリポジトリをクローンします。

   git clone https://github.com/yuhuacheng/tidal-mcp.git
   cd tidal-mcp
   

2. 仮想環境を作成し、uvを使って依存関係をインストールします。

   uv venv
   source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate
   

3. pyproject.tomlファイルからすべての依存関係を持つパッケージをインストールします。

   uv pip install --editable .
   

   これにより、pyproject.tomlファイルで定義されたすべての依存関係がインストールされ、開発モードでプロジェクトがセットアップされます。

MCPクライアントの設定

Claude Desktopの設定

このMCPサーバーをClaude Desktopに追加するには、MCP設定ファイルを更新する必要があります。以下は設定例です。 （オプションのenvセクションにTIDAL_MCP_PORT環境変数を追加することで、ポートを指定することができます）

{
  "mcpServers": {
    "TIDAL Integration": {
      "command": "/path/to/your/uv",
      "env": {
        "TIDAL_MCP_PORT": "5100"
      },
      "args": [
        "run",
        "--with",
        "requests",
        "--with",
        "mcp[cli]",
        "--with",
        "flask",
        "--with",
        "tidalapi",
        "mcp",
        "run",
        "/path/to/your/project/tidal-mcp/mcp_server/server.py"
      ]
    }
  }
}

Claude DesktopでのMCP設定のスクリーンショット例：

MCP設定のインストール手順

1. Claude Desktopを開きます。
2. 設定 > 開発者 を選択します。
3. 「設定を編集」をクリックします。
4. 変更したJSON設定を貼り付けます。
5. 設定を保存します。
6. Claude Desktopを再起動します。

提案されるプロンプトの例

設定が完了したら、以下のような質問をすることで、LLMを通じてTIDALアカウントとやり取りすることができます。

• 「このプレイリストの曲に似た、よりゆっくりでアコースティックな曲を推薦してください。」
• 「私の人気曲を元に、クールで夜遅くに聴きたい雰囲気のプレイリストを作成してください。」
• 「プレイリストXYZの曲に似た、英語以外の言語の曲を探してください。」

💡 また、モデルに以下のことを依頼することもできます。

• より多くの曲をシードとして使用し、推薦の幅を広げる。
• より長いプレイリストが必要な場合は、より多くの推薦を取得する。
• 気に入らない場合は、プレイリストを削除する（圧力はありません！）。

利用可能なツール

TIDAL MCPの統合により、以下のツールが利用可能になります。

• tidal_login：ブラウザのログインフローを通じてTIDALに認証する。
• get_favorite_tracks：TIDALからあなたのお気に入りの曲を取得する。
• recommend_tracks：パーソナライズされた音楽推薦を取得する。
• create_tidal_playlist：あなたのTIDALアカウントに新しいプレイリストを作成する。
• get_user_playlists：TIDAL上のすべてのプレイリストを一覧表示する。
• get_playlist_tracks：特定のプレイリストからすべての曲を取得する。
• delete_tidal_playlist：あなたのTIDALアカウントからプレイリストを削除する。

📄 ライセンス

MIT License

謝辞

• Model Context Protocol (MCP)
• TIDAL Python API