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