spotify-mcp-server

spotify-mcp-server

14
entertainment_and_media

The project is a Kotlin-based MCP server for interacting with the Spotify Web API, allowing playback control, playlist management, and user information retrieval. It integrates with VS Code's Copilot and runs in two modes for flexibility in use.

Kotlin MCP Server for Spotify

A Kotlin implementation of a Model Context Protocol (MCP) server that integrates with the Spotify Web API. This server offers features such as:

  • Spotify Authentication: Manage tokens.
  • Playback Control: Play, pause, skip tracks, volume control.
  • Playlist Management: Create playlists, modify tracks.
  • User Profile: Retrieve user information.

Prerequisites

  • JDK 20 or higher
  • Kotlin 2.1.10
  • Gradle
  • Spotify Developer Account

Usage

The server can operate in two modes: Standard I/O Mode and SSE Mode. It provides seamless interaction with the VS Code Copilot via MCP integration.

Development

Employs custom error handling with SpotifyResult and supports extending functionalities through new tool development.

Testing

Extensive testing support using JUnit 5 with the ability to mock HTTP responses wthrough Ktor's MockEngine.

Contributing

Contributions are welcome through pull requests.