金大哥 - TIDAL Music MCP 详情

article

README

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

TIDAL MCP 能够解决音乐平台推荐过于“聚合”的问题，让你获得更个性化、上下文感知的音乐推荐。它可依据你的输入过滤筛选，利用 TIDAL API 查找相似曲目并创建新播放列表。

示例：音乐推荐的实际效果

大多数音乐平台都提供推荐功能（每日精选、顶级艺术家、新品上市等），但即使使用最先进的系统，这些推荐仍然感觉过于“聚合”。我想要一些更个性化和上下文感知的东西。

通过 TIDAL MCP，你可以要求执行以下操作：

"根据我最近的10首最爱歌曲，找到相似的曲目——但只能是近几年发布的。"

"为我寻找与这个播放列表中歌曲类似的作品，但节奏更慢、更民谣风格。"

LLM 根据你的输入进行过滤和筛选，并使用 TIDAL 的 API 查找相似曲目，直接在你的账户中创建新播放列表。

✨ 主要特性

🌟 音乐推荐：根据您的听歌记录以及自定义标准获取个性化曲目推荐。
📜 播放列表管理：创建、查看和管理您的 TIDAL 播放列表。

🚀 快速开始

先决条件

Python 3.10+ 版本
uv（Python 包管理器）
TIDAL 订阅

安装步骤

克隆此仓库：

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

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

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

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

TIDAL Music