Splunk MCP Q0y

🚀 Spotify MCP Server

A Model Context Protocol (MCP) server for Spotify integration, allowing AI assistants like Claude to control and interact with your Spotify account.

🚀 Quick Start

This project offers a set of MCP tools that enable AI assistants to:

• Search for playlists
• Retrieve playlist details and tracks
• Control playback (play, pause, skip, previous)
• Create and modify playlists
• Toggle shuffle mode
• View the currently playing track
• Add tracks to the queue

It is built on the Model Context Protocol and the zmb3/spotify Golang SDK.

✨ Features

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context for large language models (LLMs). It allows LLMs such as Claude to interact with external systems and data sources in a secure and standardized manner.

MCP is like a USB - C port for AI applications—it provides a standardized way to connect AI models to different data sources and tools. This project implements a Spotify server that complies with the MCP specification, enabling AI assistants to control and interact with your Spotify account.

📦 Installation

Prerequisites

1. Go 1.18 or higher
2. A Spotify account (you need Spotify Premium for playback control)
3. Spotify developer credentials

Obtain Spotify API Credentials

1. Visit the Spotify Developer Dashboard
2. Log in with your Spotify account
3. Click "Create an app"
4. Fill in the app's name and description
5. After creation, you'll see your Client ID and can view your Client Secret
6. Set the redirect URI to http://127.0.0.1:1690/callback

Usage with Claude

To use this server with Claude Desktop:

1. Open Claude Desktop

2. Create or update your MCP configuration file at the following locations:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the following configuration:

{
  "mcpServers": {
    "spotify": {
      "command": "/path/to/spotify-mcp-binary",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

4. Restart Claude Desktop
5. When using the Spotify tools for the first time, you need to authenticate via the spotify_login tool.

📚 Documentation

Available Tools

Playback

• spotify_login - Initiate the Spotify authentication process to control playback
• play - Start or resume playback on your Spotify account
• pause - Pause playback on your Spotify account
• next_track - Skip to the next track in the current playback queue
• previous_track - Go back to the previous track in the current playback queue
• shuffle - Toggle the shuffle mode of your Spotify account
• current_track - Get information about the currently playing track
• get_queue - Retrieve the current playback queue
• add_tracks_to_queue - Add tracks to the current playback queue

Playlist

• get_playlist - Get details of a specific playlist
• get_playlist_tracks - Retrieve the tracks in a playlist
• create_playlist - Create a new Spotify playlist
• add_tracks_to_playlist - Add tracks to a playlist
• remove_tracks_from_playlist - Remove tracks from a playlist
• get_user_playlists - Get all of the user's playlists

📄 License

This project is licensed under the MIT License. For more details, please visit MIT License.

🔗 Contribution Guide

If you wish to contribute to this project, please refer to our Contributing Guide to learn how to get involved.