🎵 MCP Claude Spotify [Node.js - Spotify API - Claude Desktop]

MCP Claude Spotify é uma integração que permite ao Claude Desktop interagir com o Spotify usando o Model Context Protocol (MCP). Esta poderosa integração possibilita o controle assistido por IA da sua reprodução do Spotify e o gerenciamento da biblioteca diretamente da interface do Claude Desktop.

Demo

Recursos Principais:

• Autenticação Spotify Simplificada: Fluxo OAuth seguro para conectar sua conta Spotify
• Busca Abrangente: Encontre faixas, álbuns, artistas e playlists com consultas em linguagem natural
• Controle de Reprodução: Reproduza, pause e pule faixas, tudo através de comandos conversacionais
• Gerenciamento de Playlists: Crie playlists e adicione faixas com base em suas preferências
• Recomendações Personalizadas: Obtenha sugestões musicais curadas por IA com base em seus hábitos de escuta

Visão Técnica:

• Backend Node.js: Gerencia autenticação, interações com API e integração com Claude Desktop
• Model Context Protocol (MCP): Permite ao Claude gerenciar chamadas de API e manter o estado entre sessões
• Spotify Web API: Fornece acesso ao conjunto completo de recursos do Spotify e dados do usuário
• Autenticação OAuth 2.0: Garante acesso seguro às contas de usuário com escopos adequados
• Gerenciamento Automático do Servidor MCP: O servidor pode ser iniciado manualmente ou lançado automaticamente pelo Claude Desktop

Guia de Instalação:

# Clonar repositório
git clone https://github.com/imprvhub/mcp-claude-spotify
cd mcp-claude-spotify

# Instalar dependências
npm install

# Opcional: Compilar a partir do código-fonte
npm run build

Configuração da API do Spotify:

1. Obtenha suas credenciais da API do Spotify no Painel de Desenvolvedores do Spotify
2. Configure um aplicativo Spotify com o URI de redirecionamento: http://127.0.0.1:8888/callback
3. Configure o servidor MCP com seu Client ID e Secret:

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["CAMINHO_PARA_DIRETÓRIO/mcp-claude-spotify/build/index.js"],
      "env": {
        "SPOTIFY_CLIENT_ID": "seu_client_id_aqui",
        "SPOTIFY_CLIENT_SECRET": "seu_client_secret_aqui"
      }
    }
  }
}

Ferramentas Disponíveis:

A integração fornece um conjunto abrangente de ferramentas para interagir com o Spotify:

• auth-spotify: Autentique-se com sua conta Spotify
• search-spotify: Encontre conteúdo musical com consultas em linguagem natural
• play-track: Inicie a reprodução de faixas específicas
• get-current-playback: Visualize sua faixa atual e o estado de reprodução
• pause-playback: Pause sua música atual
• next-track/previous-track: Navegue pela sua fila
• get-user-playlists: Visualize suas playlists do Spotify
• create-playlist: Crie novas playlists com nomes e descrições personalizadas
• add-tracks-to-playlist: Adicione faixas a playlists existentes
• get-recommendations: Obtenha recomendações de música personalizadas com base em suas preferências
• get-top-tracks: Obtém as faixas mais reproduzidas pelo usuário durante um período de tempo específico

Requisitos do Sistema:

• Node.js 16 ou superior
• Conta Spotify Premium para funcionalidade completa de reprodução
• Aplicativo Claude Desktop

Considerações de Segurança:

• Tokens de acesso são armazenados apenas na memória durante as sessões
• Nenhum dado do usuário é armazenado no disco para proteção de privacidade
• Revogação de acesso fácil através das configurações da conta Spotify

Casos de Uso:

• Criação de playlists baseadas em estados de humor através de IA conversacional
• Controle de reprodução musical sem intervenção manual
• Descoberta de novas músicas com recomendações personalizadas por IA
• Gerenciamento da biblioteca Spotify por meio de comandos em linguagem natural
• Análise de tendências musicais pessoais para compreender padrões de escuta
• Geração de playlists retrospectivas baseadas em períodos específicos
• Identificação de gêneros e artistas preferidos para otimizar recomendações

Esta integração demonstra o poder de combinar assistentes de IA com serviços de música, criando uma experiência fluida para controlar e explorar sua música através de conversação em vez de interfaces tradicionais.

---