Tidal MCP

🚀 TIDAL MCP: 我的個性化音樂精選 🌟🎧

TIDAL MCP 旨在解決大多數音樂平臺推薦過於“籠統”的問題，讓用戶能夠基於自己的收聽歷史和自定義標準，獲得更加個性化、貼合自身需求的音樂推薦，還能方便地管理自己的播放列表。

由 Modl 託管，Modl 團隊所做的任何提交或更改都是為了確保兼容性

大多數音樂平臺都會提供推薦內容，如每日發現、熱門歌手、新上架作品等。但即便採用了最先進的系統，這些推薦往往還是讓人感覺過於“籠統”。我想要的是更具個性化且能結合具體情境的推薦。

藉助 TIDAL MCP，你可以提出類似以下的需求：

“根據我最近收藏的 10 首歌曲，找出風格相似但僅限於近年發佈的曲目。”

“為我找到與這個播放列表中的歌曲風格相似，但節奏更慢、更具原聲特色的曲目。”

大語言模型（LLM）會根據你的輸入對結果進行篩選和整理，通過 TIDAL 的 API 查找相似曲目，並直接在你的賬戶中創建新的播放列表。

🚀 快速開始

前提條件

• 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. 從 pyproject.toml 文件安裝包含所有依賴的軟件包：

   uv pip install --editable .
   

   這將安裝 pyproject.toml 文件中定義的所有依賴項，並將項目設置為開發模式。

✨ 主要特性

• 🌟 音樂推薦：基於你的收聽歷史以及自定義標準，獲得個性化的曲目推薦。
• ၊၊||၊ 播放列表管理：創建、查看和管理你的 TIDAL 播放列表。

📚 詳細文檔

MCP 客戶端配置

Claude 桌面端配置

若要將此 MCP 服務器添加到 Claude 桌面端，你需要更新 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 桌面端 MCP 配置示例截圖：

安裝 MCP 配置的步驟

1. 打開 Claude 桌面端。
2. 轉到“設置”>“開發者”。
3. 點擊“編輯配置”。
4. 粘貼修改後的 JSON 配置。
5. 保存配置。
6. 重啟 Claude 桌面端。

建議的提示語示例

配置完成後，你可以通過大語言模型與你的 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 許可證

致謝

• 模型上下文協議（MCP）
• TIDAL Python API