Tidal MCP Server

官方

使用AI搜尋、瀏覽及管理您的Tidal音樂庫。探索藝人、專輯與曲目。建立並策劃播放清單。將喜愛內容加入您的資料庫。取得個人化推薦。透過OAuth認證，由官方Tidal API提供32項工具。

GitHub
6

文件

tidal-cli

tidal-cli — Control Tidal from your terminal

npm CI smithery badge License Node

關於

tidal-cli 將 Tidal API v2 封裝成一個單一的命令列工具。搜尋目錄、管理播放清單、探索藝人、播放曲目以及管理你的媒體庫——完全無需開啟瀏覽器。每個指令都支援 --json 輸出，使其成為透過 OpenClaw 進行 LLM 代理自動化的骨幹。

功能特色

  • 搜尋 藝人、專輯、曲目、影片、播放清單以及自動完成建議
  • 藝人 — 資訊、熱門曲目、作品集、相似藝人、電台
  • 專輯 — 詳細資料、條碼查詢
  • 曲目 — 資訊、相似曲目、ISRC 查詢、電台
  • 播放清單 — 完整的 CRUD 操作、新增/移除曲目、重新排序、新增整張專輯
  • 媒體庫 — 收藏藝人、專輯、曲目、影片、播放清單
  • 播放 — 串流資訊、直接網址、透過 DASH 進行本機播放
  • 推薦 — 個人化混音（每日、探索、新發行、離線）並可深入查看混音項目
  • 歷史記錄 — 最近新增的曲目、專輯、藝人；搜尋歷史（列出、刪除、清除）
  • 稍後觀看 — 將項目加入書籤，獨立於主要媒體庫的佇列
  • 分享 — 為曲目和專輯產生公開分享連結
  • JSON 輸出 每個指令皆支援，便於腳本編寫與代理使用

安裝

npm install -g @lucaperret/tidal-cli

需求

  • Node.js >= 20
  • 一個 Tidal 帳號

快速入門

# Sign in once — opens your browser
tidal-cli auth

# Search for a track
tidal-cli search track "Around the World"

# Get artist details
tidal-cli artist info 8992

# Play a track
tidal-cli playback play 5756235

使用方式

搜尋

tidal-cli search artist "Gorillaz"
tidal-cli search album "Mezzanine"
tidal-cli search track "Teardrop"
tidal-cli search video "Stylo"
tidal-cli search playlist "Electronic"
tidal-cli search suggest "daft punk"
tidal-cli search editorial "indie rock"

藝人

tidal-cli artist info <id>
tidal-cli artist tracks <id>
tidal-cli artist albums <id>
tidal-cli artist similar <id>
tidal-cli artist radio <id>

專輯與曲目

tidal-cli album info <id>
tidal-cli album barcode <ean>
tidal-cli track info <id>
tidal-cli track similar <id>
tidal-cli track isrc <isrc>
tidal-cli track radio <id>

播放清單

tidal-cli playlist list
tidal-cli playlist create --name "Late Night Electronic"
tidal-cli playlist add-track --playlist-id <id> --track-id <id>
tidal-cli playlist add-album --playlist-id <id> --album-id <id>
tidal-cli playlist remove-track --playlist-id <id> --track-id <id>
tidal-cli playlist move-track --playlist-id <id> --track-id <id> --before <itemId>
tidal-cli playlist rename --playlist-id <id> --name "New Name"
tidal-cli playlist set-description --playlist-id <id> --desc "Updated description"
tidal-cli playlist delete --playlist-id <id>

媒體庫

tidal-cli library add --track-id <id>
tidal-cli library add --artist-id <id>
tidal-cli library add --album-id <id>
tidal-cli library add --video-id <id>
tidal-cli library remove --track-id <id>
tidal-cli library favorite-playlists
tidal-cli library add-playlist --playlist-id <id>
tidal-cli library remove-playlist --playlist-id <id>

探索與歷史記錄

tidal-cli recommend                              # all mix categories
tidal-cli recommend --type daily                 # daily | discovery | new-release | offline
tidal-cli mix items <mix-id> --type daily        # tracks inside a specific mix
tidal-cli history tracks
tidal-cli history albums
tidal-cli history artists
tidal-cli search history                         # your recent searches
tidal-cli search history-delete <entry-id>
tidal-cli search history-clear
tidal-cli user profile

稍後觀看與分享

tidal-cli saved list
tidal-cli saved add --type tracks --id <id>      # tracks | albums | artists | playlists | videos
tidal-cli saved remove --type albums --id <id>
tidal-cli share track <id>                       # creates a public share link
tidal-cli share album <id>

播放

tidal-cli playback play <id>
tidal-cli playback play <id> --quality LOSSLESS
tidal-cli playback info <id>
tidal-cli playback url <id>

音質選項：LOW、HIGH、LOSSLESS、HI_RES。

JSON 輸出

在任何子指令前加上 --json：

tidal-cli --json search track "Around the World"
tidal-cli --json playlist list
tidal-cli --json artist similar 8992

MCP 伺服器（Claude 整合）

tidal-cli 可作為遠端 MCP 伺服器，供 Claude Desktop、Smithery 以及任何相容 MCP 的客戶端使用。

在 Claude Desktop 中連接：

  1. 設定 → 連接器 → 新增自訂連接器
  2. 輸入：https://tidal-cli.lucaperret.ch/api/mcp
  3. 點擊「連接」→ 登入 Tidal → 完成

提供 40 個工具，具備 OAuth 驗證、安全註解以及 3 個提示模板。

代理自動化

tidal-cli 也可作為 OpenClaw 技能在 ClawHub 上取得。為你的 AI 代理安裝：

clawhub install tidal-cli

在 tidal-cli auth 之後，代理可以透過自動刷新權杖以非互動方式執行指令。

給 AI 代理的提示範例

  • 「用 Daft Punk 的 Discovery 專輯中最好的曲目建立一個播放清單」
  • 「找出與 Massive Attack 相似的藝人，並將他們的熱門曲目加入我的媒體庫」
  • 「我的播放清單有哪些？將新的 LCD Soundsystem 專輯加入第一個播放清單」
  • 「播放一些 Boards of Canada 的音樂」
  • 「建立一個包含 The Strokes、Arctic Monkeys 和 Interpol 的 2000 年代獨立搖滾播放清單」

腳本編寫模式

# Search then act
TRACK=$(tidal-cli --json search track "Around the World" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

# Discovery: artist → similar → top tracks → playlist
ARTIST=$(tidal-cli --json search artist "Boards of Canada" | jq -r '.[0].id')
SIMILAR=$(tidal-cli --json artist similar "$ARTIST" | jq -r '.[0].id')
TRACK=$(tidal-cli --json artist tracks "$SIMILAR" | jq -r '.[0].id')
tidal-cli playlist add-track --playlist-id <id> --track-id "$TRACK"

開發

git clone https://github.com/lucaperret/tidal-cli.git
cd tidal-cli
npm install
npm run build
npm test

執行測試

npm test           # run once
npm run test:watch # watch mode

共 143 個測試，涵蓋搜尋、播放清單、藝人、曲目、專輯、媒體庫、推薦、混音、稍後觀看、分享、搜尋歷史、驗證以及會話。

授權

tidal-cli 採用 MIT 授權條款。詳情請參閱 LICENSE 檔案。