marcelmarais/spotify-mcp-server

Spotify MCPサーバー

CursorやClaudeのようなAIアシスタントがSpotifyの再生を制御し、プレイリストを管理できる軽量なModel Context Protocol(MCP)サーバーです。

内容

• 相互作用の例
• ツール
• リード操作
• アルバム運営
• 操作再生/作成
• プレイリスト運営
• セットアップ
• 前提条件
• 設置
• Spotify開発者アプリケーションの作成
• Spotify API設定
• 認証プロセス
• Claude Desktop、カーソル、VsCode(Cline)との統合
• ストリーミング可能なHTTP
• OAuth(MCPHubおよびその他のOAuth対応クライアント)
• Docker(MCPHub推奨)

交流例

• 「エルヴィスの最初の曲を流して」
• 「テイラー・スウィフト/スリップノットのフュージョンプレイリストを作成」
• 「ワークアウトプレイリストからテクノトラックを全部仕事用プレイリストにコピーして」
• 「音量を少し下げて」

道具

オペレーションを読む

1. searchSpotify

• 説明:Spotifyでトラック、アルバム、アーティスト、プレイリストを検索
• パラメータ:
• query(文字列):検索語
• type(文字列):検索するアイテムの種類(トラック、アルバム、アーティスト、プレイリスト)
• limit(番号、任意):返却できる最大結果数(1-10、デフォルト:10)

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.

Example Interactions

• “Play Elvis’s first song”
• “Create a Taylor Swift / Slipknot fusion playlist”
• “Copy all the techno tracks from my workout playlist to my work playlist”
• “Turn the volume down a bit”

Tools

Read Operations

1. searchSpotify

   • Description: Search for tracks, albums, artists, or playlists on Spotify
   • Parameters:
     • query (string): The search term
     • type (string): Type of item to search for (track, album, artist, playlist)
     • limit (number, optional): Maximum number of results to return (1-10, default: 10)
     • offset (number, optional): Index of the first result to return (default: 0)
   • Returns: List of matching items with their IDs, names, and additional details
   • Example: searchSpotify("bohemian rhapsody", "track", 10)

2. getNowPlaying

   • Description: Get information about the currently playing track on Spotify, including device and volume info
   • Parameters: None
   • Returns: Object containing track name, artist, album, playback progress, duration, playback state, device info, volume, and shuffle/repeat status
   • Example: getNowPlaying()

3. getMyPlaylists

   • Description: Get a list of the current user’s playlists on Spotify
   • Parameters:
     • limit (number, optional): Maximum number of playlists to return (default: 20)
     • offset (number, optional): Index of the first playlist to return (default: 0)
   • Returns: Array of playlists with their IDs, names, track counts, and public status
   • Example: getMyPlaylists(10, 0)

4. getPlaylistTracks