音乐推荐服务

TIDAL MCP是一款基于用户自定义条件的个性化音乐推荐和播放列表管理服务,适用于音乐爱好者。

  • by yuhuacheng
  • Python
  • 本地部署
  • 51 星标
  • 更新于
在 GitHub 查看 yuhuacheng/tidal-mcp

使用说明

TIDAL MCP:我的定制选择🌟🎧

大多数音乐平台都提供推荐——每日发现、顶级艺术家、新来者等。——但即使有了最先进的系统,他们也经常觉得太“聚合”了。我想要一些更注重习俗和背景的东西。

使用TIDAL MCP,您可以要求以下内容:

“根据我最近最喜欢的10首歌曲,找到类似的曲目,但只有近年来的曲目。”

“找到与此播放列表中类似的曲目,但速度较慢,声音更大。”

LLM使用您的输入过滤和策划结果,通过TIDAL的API找到类似的曲目,并直接在您的帐户中构建新的播放列表。

特性

  • 🌟 音乐推荐:根据您的收听历史获得个性化曲目推荐 加上您的自定义标准.
  • ၊၊||၊ 播放列表管理:创建、查看和管理您的TIDAL播放列表

快速开始

先决条件

  • Python 3.10+
  • 紫外线 (Python包管理器)
  • TIDAL订阅

安装

  1. 克隆此存储库:

    git clone https://github.com/yuhuacheng/tidal-mcp.git
    cd tidal-mcp
    
  2. 使用uv创建虚拟环境并安装依赖项:

    uv venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    
  3. 从pyproject.toml文件安装包含所有依赖项的包:

    uv pip install --editable .
    

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

MCP客户端配置

Claude桌面配置

要将此MCP服务器添加到Claude Desktop,您需要更新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 Desktop中MCP配置的示例截图:

安装MCP配置的步骤

  1. 打开克劳德桌面
  2. 前往“设置”>“开发人员”
  3. 点击“编辑配置”
  4. 粘贴修改后的JSON配置
  5. 保存配置
  6. 重新启动克劳德桌面

建议的快速启动程序

配置后,您可以通过LLM与您的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许可证

致谢