Spotify

Controle a reprodução do Spotify e gerencie suas músicas curtidas usando LLMs.

Documentação

Spotify MCP Server

Um servidor MCP simples para controlar a reprodução do Spotify e gerenciar suas músicas curtidas via LLMs.

Recursos

  • Reproduzir e pausar a reprodução do Spotify
  • Obter informações sobre a faixa atual
  • Adicionar a faixa atual às suas músicas curtidas

Configuração

  1. Clone o repositório:

    git clone https://github.com/yourusername/spotify-mcp-server.git
    cd spotify-mcp-server
    
  2. Crie e ative um ambiente virtual:

    python3 -m venv .venv
    source .venv/bin/activate
    
  3. Instale as dependências:

    pip install uv
    pip install -r requirements.txt
    
  4. Crie um arquivo .env:

    SPOTIPY_CLIENT_ID=your_spotify_client_id
    SPOTIPY_CLIENT_SECRET=your_spotify_client_secret
    SPOTIPY_REDIRECT_URI=http://localhost:8888/callback
    
  5. Execute o servidor:

    python main.py
    

Integração com Claude Desktop (Servidor MCP)

Para usar este servidor como um servidor MCP com o Claude, adicione a seguinte entrada ao seu arquivo de configuração do Claude (geralmente localizado em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "spotify-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}
  • Substitua /ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server pelo caminho real do seu projeto
  • Se o comando uv não for reconhecido, forneça o caminho absoluto para o executável uv (pode ser encontrado com which uv no MacOS)
  • Certifique-se de que suas variáveis de ambiente estejam definidas na configuração ou por meio de um arquivo .env.
  • Reinicie o Claude após editar o arquivo de configuração.

Notas

Sessão de Exemplo

Abaixo está um exemplo de sessão usando o Claude com o servidor MCP do Spotify:

Example Conversation

Exemplo de interação:

User: Play the current track using Spotify MCP server
Claude: Playback started successfully

User: What song is playing?
Claude: Currently playing: Shape of You by Ed Sheeran

User: Like this song
Claude: Added 'Shape of You' to your Liked Songs.