Spotify MCP Server

Interaja com a API do Spotify para gerenciar playlists e controlar a reprodução de música.

GitHub
1
Experimente este MCPPatrocinado

Documentação

title: Spotify MCP Server emoji: 🎵 colorFrom: blue colorTo: purple sdk: gradio sdk_version: 5.33.1 app_file: server.py pinned: false

Spotify MCP Server

Um servidor MCP baseado em Gradio que fornece uma interface amigável para interagir com a API do Spotify. Este servidor oferece várias ferramentas para gerenciar sua experiência no Spotify, desde autenticação até gerenciamento de playlists e controle de reprodução de música.

Vídeo de Demonstração

Assista ao vídeo de demonstração

Recursos

  • Autenticação: Autenticação segura do Spotify usando OAuth2
  • Busca de Músicas: Busque faixas e obtenha informações sobre artistas
  • Gerenciamento de Fila: Adicione músicas à sua fila do Spotify (requer Spotify Premium)
  • Reproduzidas Recentemente: Veja suas faixas reproduzidas recentemente
  • Gerenciamento de Playlists:
    • Crie novas playlists
    • Veja playlists existentes
    • Adicione músicas a playlists
  • Insights do Usuário:
    • Veja seus artistas mais ouvidos
    • Veja suas faixas mais ouvidas
    • Obtenha informações sobre gêneros

Requisitos

  • Python 3.x
  • Conta Spotify Premium (necessária para alguns recursos de gerenciamento de fila)
  • Conta de desenvolvedor Spotify para credenciais da API

Configuração

  1. Clone este repositório
  2. Instale as dependências necessárias: 
    pip install gradio spotipy

Configuração

Obtendo Chaves da API do Spotify

  1. Crie uma conta em developer.spotify.com
  2. Navegue até o painel de controle
  3. Crie um novo aplicativo com as seguintes configurações:
    • URI de redirecionamento: http://127.0.0.1:5000/callback (você pode escolher qualquer porta, mas deve usar http e um endereço de loopback explícito)
    • Nota: Talvez seja necessário reiniciar seu ambiente MCP (por exemplo, Claude Desktop) uma ou duas vezes antes de funcionar

Variáveis de Ambiente

O servidor usa as seguintes variáveis de ambiente: Por favor, crie um arquivo .env com as credenciais

  • CLIENT_ID: Seu ID de cliente da API do Spotify
  • CLIENT_SECRET: Seu segredo de cliente da API do Spotify
  • REDIRECT_URI: Sua URI de redirecionamento da API do Spotify (padrão: http://127.0.0.1:5000/callback)

Executando Localmente

Este projeto foi projetado para ser executado localmente e ainda não está configurado para ambientes efêmeros (por exemplo, uso com uvx). Para executar:

  1. Clone este repositório
  2. Configure suas variáveis de ambiente
  3. Execute o servidor

Exemplos de Consultas para Claude Desktop

Experimente estas consultas de exemplo no Claude Desktop para explorar diferentes recursos:

Descoberta e Análise de Música

"Mostre-me meus 10 artistas mais ouvidos e seus gêneros dos últimos 6 meses"

Criação Inteligente de Playlists

"Crie uma playlist com minhas 20 faixas mais ouvidas deste mês"

Gerenciamento de Fila

"Busque por 'I Like Me Better' e adicione à minha fila"

Organização de Playlists

"Mostre-me todas as minhas playlists"

Curadoria de Música

"Compare minhas 10 faixas mais ouvidas deste mês com meus favoritos de todos os tempos"

Ações Rápidas

"Mostre-me minhas 5 músicas reproduzidas mais recentemente"

Endpoints da API

O servidor expõe vários endpoints por meio das interfaces Gradio:

  • add_to_queue_song: Adicione uma música à fila (requer Premium)
  • get_artist_and_track: Busque por faixas
  • auth_with_spotify: Autentique-se com o Spotify
  • get_recently_played_songs: Obtenha faixas reproduzidas recentemente
  • create_playlist: Crie uma nova playlist
  • get_playlist_name_and_id: Obtenha informações da playlist
  • add_songs_to_playlist: Adicione músicas a uma playlist
  • get_users_top_artists: Obtenha os artistas mais ouvidos do usuário
  • get_user_top_tracks: Obtenha as faixas mais ouvidas do usuário

Recursos Premium

Os seguintes recursos exigem uma conta Spotify Premium:

  • Adicionar músicas à fila

Configuração do Claude Desktop

Para usar este servidor MCP com o Claude Desktop, adicione a seguinte configuração às suas configurações (o número da porta pode variar, por favor verifique):

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:7860/gradio_api/mcp/sse"]
    }
  }
}

Esta configuração permite que o Claude Desktop se conecte ao servidor MCP Gradio executando na porta 7860.

Tags

mcp-server-track