TIDAL Music

🚀 TIDAL MCP：我的自定义选择 🌟🎧

TIDAL MCP 旨在解决大多数音乐平台推荐过于“聚合”的问题，为用户提供更个性化、上下文感知的音乐推荐。用户可以依据自身听歌记录和自定义标准获取推荐，还能直接在账户中创建新的播放列表。

🚀 快速开始

先决条件

• 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. 使用以下命令安装包含所有依赖项的包：

uv pip install --editable .

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

✨ 主要特性

• 🌟 音乐推荐：根据您的听歌记录以及自定义标准获取个性化曲目推荐。
• 📜 播放列表管理：创建、查看和管理您的 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. 使用以下命令安装包含所有依赖项的包：

uv pip install --editable .

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

📚 详细文档

MCP 客户端配置

Claude Desktop 配置

要将此 MCP 服务器添加到 Claude Desktop 中，需要更新 MCP 配置文件。以下是示例配置： （你可以通过添加一个可选的 env 部分并指定 TIDAL_MCP_PORT 环境变量来指定端口）

{
  "mcpServers": {
    "TIDAL 整合": {
      "command": "/path/to/your/uv",
      "env": {
        "TIDAL_MCP_PORT": "5100"
      },
      "args": [
        "run",
        "--with",
        "requests",
        "--with",
        "mcp[cli]",
        "--with",
        "flask",
        "--with",
        "tidal",
        "/path/to/tidal"
      ]
    }
  }
}

建议提示启动

以下是您可以尝试的一些示例：

• 探索新的音乐流派，但我喜欢轻柔的旋律和复杂的编曲。
• 推荐适合早晨锻炼的高能量歌曲，同时保持积极向上的氛围。
• 寻找与最近发布的流行单曲风格相似但更小众的歌曲。

工具

• tidal 登录：用于 TIDAL 身份验证。
• tidal 搜索：根据艺术家或歌曲名称搜索 TIDAL。
• tidal 推荐：根据您的听歌记录推荐曲目。
• tidal 播放列表：创建和管理 TIDAL 播放列表。

📄 许可证

项目采用 MIT 许可证，具体请参见 LICENSE 文件。

致谢

感谢以下项目的贡献：

• uv
• TIDAL API