ほとんどの音楽プラットフォームは、デイリー・ディスカバリー、トップ・アーティスト、ニュー・ラヴェントなどの推奨事項を提供していますが、最先端のシステムでも、しばしば「集計」を感じます。 よりカスタムでコンテキストアウェアが欲しい。

TIDAL MCP では、以下のようなことを要求できます。

「過去10のお気に入りに基づいて、類似のトラックを見つけるが、近年のものだけ」 ツイート 「このプレイリストのように、遅く、よりアコースティック」

LLM は、入力を使用して結果をフィルタリングし、TIDAL の API を介して同様のトラックを見つけ、アカウントに直接新しいプレイリストを作成します。

##特徴

• ✔音楽の推奨事項:あなたのリスニング履歴に基づいてパーソナライズされたトラックの推奨事項を入手してくださいあなたのカスタム基準。
• ၊၊ ၊ ** TIDALプレイリストの作成、ビュー、管理

クイックスタート

前提条件

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

インストール

1. このリポジトリをクローンする:

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

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

pyproject で定義されている全ての依存関係をインストールします.

TIDAL MCP: My Custom Picks 🌟🎧

Most music platforms offer recommendations — Daily Discovery, Top Artists, New Arrivals, etc. — but even with the state-of-the-art system, they often feel too “aggregated”. I wanted something more custom and context-aware.

With TIDAL MCP, you can ask for things like:

“Based on my last 10 favorites, find similar tracks — but only ones from recent years.”

“Find me tracks like those in this playlist, but slower and more acoustic.”

The LLM filters and curates results using your input, finds similar tracks via TIDAL’s API, and builds new playlists directly in your account.

Features

• 🌟 Music Recommendations: Get personalized track recommendations based on your listening history plus your custom criteria.
• ၊၊||၊ Playlist Management: Create, view, and manage your TIDAL playlists

Quick Start

Prerequisites

• Python 3.10+
• uv (Python package manager)
• TIDAL subscription

Installation

1. Clone this repository:

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

2. Create a virtual environment and install dependencies using uv:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install the package with all dependencies from the pyproject.toml file:

   uv pip install --editable .
   

   This will install all dependencies defined in the pyproject.toml file and set up the project in development mode.

MCP Client Configuration

Claude Desktop Configuration

To add this MCP server to Claude Desktop, you need to update the MCP configuration file. Here’s an example configuration: (you can specify the port by adding an optional env section with the TIDAL_MCP_PORT environment variable)

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

Example scrrenshot of the MCP configuration in Claude Desktop:

Steps to Install MCP Configuration

1. Open Claude Desktop
2. Go to Settings > Developer
3. Click on “Edit Config”
4. Paste the modified JSON configuration
5. Save the configuration
6. Restart Claude Desktop

Suggested Prompt Starters