MCPSpotify

O MCP Spotify Server oferece uma integração entre LLMs e o Spotify, permitindo autenticação via OAuth2, busca por músicas, artistas, álbuns e playlists, além de controle de reprodução, informações da faixa atual e gerenciamento de dispositivos. As ferramentas disponíveis permitem iniciar a autenticação, finalizar com tokens, pesquisar conteúdo musical, tocar ou controlar a reprodução, listar dispositivos e playlists, e tocar playlists específicas. Para usar, configure as credenciais do Spotify, exponha o servidor com ngrok (ou outra solução) para o fluxo de OAuth, e utilize os comandos MCP descritos no README para interagir com a API do Spotify através do seu cliente MCP (Cursor, Claude Desktop, etc.).

Pré-requisitos:

• Node.js v18+ instalado
• Conta Spotify (Premium recomendado para recursos completos)
• Aplicação registrada no Spotify Developer Dashboard
• ngrok para expor o servidor local (ou alternativa similar)

Instalação passo a passo:

1. Clone o repositório:

git clone https://github.com/fborello/MCPSpotify.git
cd MCPSpotify

2. Instale as dependências:

npm install

3. Instale o ngrok (conforme sua plataforma):

macOS (Homebrew):

brew install ngrok/ngrok/ngrok

Windows (Chocolatey):

choco install ngrok

Linux:

# Alternativas comuns para Linux (ou baixe direto do site)
curl -s https://ngrok-agent.s3.amazonaws.com/ngrok.asc | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null
echo "deb https://ngrok-agent.s3.amazonaws.com buster main" | sudo tee /etc/apt/sources.list.d/ngrok.list
sudo apt update && sudo apt install ngrok

Ou baixe diretamente do site oficial: https://ngrok.com/download

4. Configure as variáveis de ambiente:

cp env.example .env

5. Edite o arquivo .env com suas credenciais Spotify:

SPOTIFY_CLIENT_ID=seu_client_id_aqui
SPOTIFY_CLIENT_SECRET=seu_client_secret_aqui
SPOTIFY_REDIRECT_URI=http://localhost:3000/callback

6. Configure o MCP (opcional) para seu cliente MCP (Cursor, Claude Desktop, etc.). Exemplos no README mostram como copiar os modelos de configuração para o seu caminho local.

7. Inicie o servidor conforme o fluxo de desenvolvimento ou produção descrito no README (npm run dev para desenvolvimento; npm run build e npm start para produção).

Dicas úteis: - Certifique-se de que a Redirect URI no Spotify Dashboard coincide com a que está no arquivo .env e com a URL fornecida pelo ngrok (quando exposto publicamente). - Se encontrar erros de módulo não encontrado, utilize node dist/index.js na configuração do MCP em vez de xs.ts diretamente, e rode npm run build antes de usar. - Mantenha as credenciais locais; o servidor não envia informações para terceiros além do Spotify. - Use ngrok para facilitar o fluxo OAuth durante o desenvolvimento; atualize a Redirect URI no Spotify Dashboard sempre que mudar a URL exposta pelo ngrok. - Verifique se o arquivo .env está presente e apontando para as credenciais corretas antes de iniciar o servidor.