Tidal MCP

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

TIDAL MCP 旨在解决大多数音乐平台推荐过于“笼统”的问题，让用户能够基于自己的收听历史和自定义标准，获得更加个性化、贴合自身需求的音乐推荐，还能方便地管理自己的播放列表。

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

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

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

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

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

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

🚀 快速开始

前提条件

• 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 文件中定义的所有依赖项，并将项目设置为开发模式。

✨ 主要特性

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

📚 详细文档

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