Tidal MCP

🚀 TIDAL MCP：我的个性化音乐精选 🌟🎧

TIDAL MCP专为满足用户对个性化音乐推荐的需求而设计。在大多数音乐平台的推荐往往显得过于“笼统”的情况下，TIDAL MCP能依据用户的特定要求和聆听历史，筛选并整理出符合个性化标准的音乐，还能直接在用户账户中创建新的播放列表。

由Modl托管，Modl团队所做的任何提交或更改都是为了确保兼容性

大多数音乐平台都会提供推荐内容，如每日发现、热门歌手、新上架作品等。然而，即便采用了最先进的系统，这些推荐往往仍给人一种过于“笼统”的感觉。我期望有更具个性化且能结合具体情境的推荐。

借助TIDAL MCP，你可以提出类似以下的需求：

“根据我最近收藏的10首歌曲，找出风格相似但仅限于近年发行的曲目。”

“为我找到与这个播放列表中的歌曲风格相似，但节奏更慢且更具原声风格的曲目。”

大语言模型（LLM）会根据你的输入对结果进行筛选和整理，通过TIDAL的API查找相似曲目，并直接在你的账户中创建新的播放列表。

✨ 主要特性

• 🌟 音乐推荐：基于你的聆听历史以及自定义标准，获取个性化的曲目推荐。
• ၊၊||၊ 播放列表管理：创建、查看和管理你的TIDAL播放列表

🚀 快速开始

前提条件

• Python 3.10及以上版本
• uv（Python包管理器）
• TIDAL订阅服务

📦 安装指南

1. 克隆此仓库：

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

2. 创建虚拟环境并使用uv安装依赖项：

   uv venv
   source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
   

3. 从pyproject.toml文件安装包含所有依赖项的软件包：

   uv pip install --editable .
   

   这将安装pyproject.toml文件中定义的所有依赖项，并将项目设置为开发模式。

MCP客户端配置

Claude桌面端配置

要将此MCP服务器添加到Claude桌面端，你需要更新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桌面端MCP配置的示例截图：

安装MCP配置的步骤

1. 打开Claude桌面端
2. 转到“设置”>“开发者”
3. 点击“编辑配置”
4. 粘贴修改后的JSON配置
5. 保存配置
6. 重启Claude桌面端

💡 使用建议

配置完成后，你可以通过大语言模型与你的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许可证

致谢

• 模型上下文协议（MCP）
• TIDAL Python API