潮汐-MCP

Name: 潮汐-MCP
Author: yuhuacheng

作者：yuhuacheng30 星标更新：2025-05-02

安装使用来源：spider==github.com

项目介绍

TIDAL MCP: 我的自定义推荐 🌟🎧

演示：音乐推荐在行动

大多数音乐平台都提供推荐——每日发现、顶级艺术家、新发行等——但即使是最先进的系统，它们往往也显得过于“聚合”。我想要的是更加个性化和情境感知的推荐。

通过 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

从 pyproject.toml 文件安装带有所有依赖项的包：
```
uv pip install --editable .
```
这将安装 pyproject.toml 文件中定义的所有依赖项，并以开发模式设置项目。

MCP 客户端配置

Claude 桌面配置

要将此 MCP 服务器添加到 Claude 桌面，你需要更新 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",
        "tidalapi",
        "mcp",
        "run",
        "/path/to/your/project/tidal-mcp/mcp_server/server.py"
      ]
    }
  }
}

Claude 桌面中的 MCP 配置示例截图： Claude MCP 配置

安装 MCP 配置的步骤

打开 Claude 桌面
转到设置 > 开发者
点击“编辑配置”
粘贴修改后的 JSON 配置
保存配置
重启 Claude 桌面

建议的提示启动器

配置完成后，你可以通过向 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 许可证