TIDAL MCP: Mis selecciones personalizadas 🌟🎧

La mayoría de las plataformas musicales ofrecen recomendaciones (Descubrimiento diario, Artistas destacados, Novedades, etc.), pero incluso con el sistema de vanguardia, suelen parecer demasiado "agregadas". Quería algo más personalizado y contextual.

Con TIDAL MCP, puedes solicitar cosas como:

"Basándome en mis últimos 10 favoritos, busca canciones similares, pero solo de los últimos años".

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

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

Características

• 🌟 Recomendaciones musicales : obtén recomendaciones de pistas personalizadas según tu historial de escucha y tus criterios personalizados .

• Gestión de listas de reproducción : crea, visualiza y gestiona tus listas de reproducción de TIDAL

Related MCP server: Tempo

Inicio rápido

Prerrequisitos

• Python 3.10+

• uv (administrador de paquetes de Python)

• Suscripción a TIDAL

Instalación

1. Clonar este repositorio:

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

2. Cree un entorno virtual e instale dependencias usando uv:

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

3. Instale 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 del escritorio de Claude

Para agregar este servidor MCP a Claude Desktop, debe actualizar el archivo de configuración de MCP. A continuación, se muestra un ejemplo de configuración: (puede especificar el puerto agregando una sección env opcional 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"
      ]
    }
  }
}

Ejemplo de captura de pantalla de la configuración de MCP en Claude Desktop:

Pasos para instalar la configuración de MCP

1. Abra Claude Desktop

2. Vaya a Configuración > Desarrollador

3. Haga clic en "Editar configuración"

4. Pegue la configuración JSON modificada

5. Guardar la configuración

6. Reiniciar Claude Desktop

Sugerencias de inicio

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

• “Recomiendo 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 favoritas, pero centrada en un ambiente relajado y nocturno”.

• “Encuentra canciones como estas en la lista de reproducción XYZ, pero en idiomas distintos del inglés”.

💡También puedes pedirle a la modelo que:

• Utilice más pistas como semillas para ampliar la inspiración.

• Devuelve más recomendaciones si deseas una lista de reproducción más larga.

• O elimina una lista de reproducción si no te gusta: ¡sin presión!

Herramientas disponibles

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

• tidal_login : Autenticarse con TIDAL a través del flujo de inicio de sesión del navegador

• get_favorite_tracks : recupera tus pistas favoritas de TIDAL

• recommend_tracks : Obtén recomendaciones musicales personalizadas

• create_tidal_playlist : Crea una nueva lista de reproducción en tu cuenta TIDAL

• get_user_playlists : enumera todas tus listas de reproducción en TIDAL

• get_playlist_tracks : recupera todas las pistas de una lista de reproducción específica

• delete_tidal_playlist : Elimina una lista de reproducción de tu cuenta TIDAL

Licencia

Licencia MIT

Expresiones de gratitud

• Protocolo de Contexto Modelo (MCP)

• API de Python de TIDAL