Spotify Media Control Protocol Utility

A high-velocity implementation of the FastMCP framework tailored specifically for the Spotify ecosystem.

Demonstration

Access point for visual confirmation: https://drive.google.com/file/d/1jGGQBzeXSKSJijeUwFZLdvrKPmPuogGd/

Prerequisites for Operation

Ensure the following dependencies are satisfied before deployment:

• The [uv] dependency manager must be installed. Reference: https://docs.astral.sh/uv/getting-started/installation/
• Access credentials for the [Spotify Web API] are mandatory. Obtainable from: https://developer.spotify.com/dashboard/applications

Deployment Procedure

1. Initiate a complete clone of this source code repository onto your local machine.
2. Construct a configuration file named .env within the repository's primary directory. Populate this file by replicating and substituting values from the provided .env.example template with your procured Spotify API authentication secrets.
3. Credentials acquisition involves navigating to the [Spotify Developer Dashboard] and formally registering a new application to generate the necessary keys.
4. Navigate to the Cursor IDE configuration panel: Access Settings > Features > MCP Servers > Click the '+' to Add a new server entry.
5. Configure the server details as follows: Set the Name to "Spotify", designate the Type as "command", and specify the execution Command as: uv --directory <path-to-repository/mcp-spotify> run main.py

Upon successful configuration, the utility should now appear in your list of installed tools.

Operational Verification

Activate the "agent" operational mode within the Composer interface. Provided that the Spotify application is running and actively connected to an accessible playback device, you can immediately direct Cursor to manage your audio experience.

Supported Capabilities

This section illustrates various interaction modalities available through the Spotify MCP tool within the Cursor Composer environment:

1. User Query: "Display my existing playlists." System Output: "Your curated collections are: Chill Vibes, Workout Mix, Top Hits."

2. User Action: "Initiate playback of the 'Chill Vibes' collection."

3. User Command: "Halt the current audio stream." System Output: "Playback has been successfully suspended."

4. User Command: "Restart paused audio playback." System Output: "Resumption sequence commencing..."

5. User Query: "Identify the currently playing track information." System Output: "Currently active track: 'Faded' by Alan Walker."

6. User Request: "Provide a biography of the current artist and list several of their most popular recordings." System Output: "Artist Profile: Alan Walker. Featuring top tracks below."

7. User Query: "Enumerate my most frequently streamed artists over the preceding six months." System Output: "Your top-performing artists by listenership are detailed here..."

8. User Command: "Execute a search query for the entity 'Coldplay'." System Output: "Artist match confirmed: Coldplay. Presenting their primary hits..."

9. User Command: "Commence playback of the specific track titled 'Fix You'." System Output: "Initiating playback sequence for 'Fix You'..."

10. User Query: "Render the contents of the current playback queue." System Output: "Active queue contents: Track 1, Track 2, Track 3..."

11. User Command: "Insert the composition 'Paradise' into the pending queue." System Output: "Successfully appended 'Paradise' by Coldplay to the sequence."

12. User Command: "Reorder the queue to position 'Paradise' one slot higher."

13. User Command: "Activate continuous playback looping for the current selection."

14. User Command: "Express approval for this track. Suggest compositions with equivalent sonic characteristics." System Output: "Recommendations generated based on the characteristics of this specific track..."

15. User Command: "Incorporate this specific recording into my 'Chill Vibes' playlist structure."

Further Capabilities Available: - Scrubbing playback to an arbitrarily defined timestamp within the active media object. - Inspection of the exhaustive current playback status report. - Ability to execute batch skips, advancing through several queued items simultaneously.

Should your operational requirements necessitate support for additional functionalities, please feel encouraged to submit an official issue report!