대부분의 음악 플랫폼은 권장 사항을 제공합니다. Daily Discovery, Top Artists, New Arrivals 등 -하지만 최첨단 시스템과도 종종 "집합"을 느낄 수 있습니다. 나는 더 많은 사용자 정의 및 context-aware를 원했습니다.

TIDAL MCP를 사용하면 다음과 같은 것들을 요청할 수 있습니다.

“내 마지막 10 좋아하는에 기반, 유사한 트랙을 찾기 — 하지만 최근 몇 년에서 하나.” · “이 재생 목록에서 그와 같은 트랙을 공유하지만 더 느리고 더 음향.”

입력을 사용하여 LLM 필터와 큐레이트 결과, TIDAL의 API를 통해 유사한 트랙을 찾아, 당신의 계정에 직접 새로운 재생 목록을 구축.

특징

• ✈️Music 권고**: 청취 역사에 기반한 맞춤형 트랙 권고**.
• ||플레이리스트 관리**: TIDAL 재생 목록 작성,보기 및 관리

빠른 시작

# 필수품

• 파이썬 3.10+
• uv (Python 포장 매니저)
• TIDAL 구독

설치

1. Clone 이 저장소:

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