TIDAL MCP: 내 맞춤 추천

TIDAL MCP: 내 맞춤 추천 🌟🎧

대부분의 음악 플랫폼은 일일 검색, 인기 아티스트, 신곡 추천 등 다양한 추천 기능을 제공하지만, 최첨단 시스템임에도 불구하고 너무 "집계된" 느낌이 드는 경우가 많습니다. 저는 좀 더 개인 맞춤형이고 상황에 맞는 추천 기능을 원했습니다.

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

"제가 가장 좋아하는 곡 10개를 기준으로 비슷한 곡을 찾아주세요. 하지만 최근 몇 년의 곡만 찾아주세요."
"이 플레이리스트에 있는 것과 비슷한 트랙을 찾아주세요. 하지만 더 느리고 어쿠스틱한 트랙이에요."

LLM은 사용자의 입력을 바탕으로 결과를 필터링하고 큐레이션하며, TIDAL API를 통해 유사한 트랙을 찾고, 사용자 계정에 직접 새로운 재생 목록을 구축합니다.

특징

🌟 음악 추천 : 청취 기록 과 사용자 지정 기준 에 따라 개인화된 트랙 추천을 받으세요.
၊၊||၊ 재생 목록 관리 : TIDAL 재생 목록을 만들고, 보고, 관리하세요

빠른 시작

필수 조건

파이썬 3.10+
uv (Python 패키지 관리자)
TIDAL 구독

설치

이 저장소를 복제하세요:지엑스피1
uv를 사용하여 가상 환경을 만들고 종속성을 설치합니다.
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
pyproject.toml 파일에서 모든 종속성을 포함한 패키지를 설치합니다.
uv pip install --editable .
이렇게 하면 pyproject.toml 파일에 정의된 모든 종속성이 설치되고 프로젝트가 개발 모드로 설정됩니다.

MCP 클라이언트 구성

클로드 데스크톱 구성

이 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 구성 설치 단계

클로드 데스크톱 열기
설정 > 개발자로 이동하세요
"구성 편집"을 클릭하세요
수정된 JSON 구성을 붙여넣습니다.
구성을 저장합니다
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 라이센스

TIDAL MCP: My Custom Picks

Integrations