TIDAL MCP: My Custom Picks

Recomendaciones musicales personalizadas y gestión de listas de reproducción para TIDAL, impulsadas por su API y filtrado con LLM.

GitHub
45

Documentación

TIDAL MCP: My Custom Picks 🌟🎧

Demo: Music Recommendations in Action

La mayoría de las plataformas de música ofrecen recomendaciones — Descubrimiento Diario, Artistas Principales, Novedades, etc. — pero incluso con el sistema de última generación, a menudo se sienten demasiado "agregadas". Quería algo más personalizado y consciente del contexto.

Con TIDAL MCP, puedes pedir cosas como:

"Basado en mis últimos 10 favoritos, encuentra canciones similares — pero solo de los últimos años."

"Encuéntrame canciones como las de esta lista de reproducción, pero más lentas y acústicas."

El LLM filtra y cura los resultados usando tu entrada, encuentra canciones similares a través de la API de TIDAL, y crea nuevas listas de reproducción directamente en tu cuenta.

TIDAL: My Custom Picks MCP server

Características

  • 🌟 Recomendaciones musicales: Obtén recomendaciones de canciones personalizadas basadas en tu historial de escucha más tus criterios personalizados.
  • ၊၊||၊ Gestión de listas de reproducción: Crea, visualiza y gestiona tus listas de reproducción de TIDAL

Inicio rápido

Requisitos previos

  • Python 3.10+
  • uv (gestor de paquetes de Python)
  • Suscripción a TIDAL

Instalación

  1. Clona este repositorio:

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

  2. Crea un entorno virtual e instala las dependencias usando uv:

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

  3. Instala el paquete con todas las dependencias del archivo pyproject.toml:

    uv pip install --editable .

    Esto instalará todas las dependencias definidas en el archivo pyproject.toml y configurará el proyecto en modo de desarrollo.

Configuración del cliente MCP

Configuración de Claude Desktop

Para agregar este servidor MCP a Claude Desktop, debes actualizar el archivo de configuración de MCP. Aquí tienes un ejemplo de configuración: (puedes especificar el puerto agregando una sección opcional env con la variable de entorno 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"
      ]
    }
  }
}

Captura de pantalla de ejemplo de la configuración de MCP en Claude Desktop: Claude MCP Configuration

Pasos para instalar la configuración de MCP

  1. Abre Claude Desktop
  2. Ve a Configuración > Desarrollador
  3. Haz clic en "Editar configuración"
  4. Pega la configuración JSON modificada
  5. Guarda la configuración
  6. Reinicia Claude Desktop

Sugerencias de prompts iniciales

Una vez configurado, puedes interactuar con tu cuenta de TIDAL a través de un LLM haciendo preguntas como:

  • “Recomienda canciones como las de esta lista de reproducción, pero más lentas y acústicas.”
  • “Crea una lista de reproducción basada en mis canciones principales, pero centrada en vibraciones relajadas de altas horas.”
  • “Encuentra canciones como estas en la lista de reproducción XYZ pero en idiomas distintos del inglés.”

💡 También puedes pedirle al modelo que:

  • Use más canciones como semillas para ampliar la inspiración.
  • Devuelva más recomendaciones si quieres una lista más larga.
  • O elimine una lista de reproducción si no te convence, ¡sin presión!

Herramientas disponibles

La integración de TIDAL MCP proporciona las siguientes herramientas:

  • tidal_login: Autentícate con TIDAL mediante el flujo de inicio de sesión del navegador
  • get_favorite_tracks: Recupera tus canciones favoritas de TIDAL
  • recommend_tracks: Obtén recomendaciones musicales personalizadas
  • create_tidal_playlist: Crea una nueva lista de reproducción en tu cuenta de TIDAL
  • get_user_playlists: Lista todas tus listas de reproducción en TIDAL
  • get_playlist_tracks: Recupera todas las canciones de una lista de reproducción específica
  • delete_tidal_playlist: Elimina una lista de reproducción de tu cuenta de TIDAL

Licencia

MIT License

Agradecimientos