Saltar para o conteúdo principal
MCP (Model Context Protocol) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Com o Suno MCP Server fornecido pela AceData Cloud, você pode gerar música, letras e gerenciar projetos de áudio diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

​
Visão Geral das Funcionalidades

O Suno MCP Server oferece as seguintes funcionalidades principais:
  • Geração de Música — Geração de música AI através de prompts de texto
  • Criação Personalizada — Controle total sobre letras, títulos e estilos musicais
  • Continuação de Canções — Prolongar canções existentes a partir de qualquer ponto no tempo
  • Covers/Mixagens — Criar versões cover em diferentes estilos
  • Geração de Letras — Gerar letras estruturadas com base em descrições
  • Personagens Vocais — Salvar e reutilizar estilos de voz
  • Conversão de Mídia — Obter MP4, WAV, MIDI, separação de vozes, etc.
  • Otimização de Estilo — Otimizar etiquetas de estilo musical
  • Consulta de Tarefas — Monitorar o progresso da geração e obter resultados

​
Preparativos

Antes de usar, você precisa obter o Token da API da AceData Cloud:
  1. Registre-se ou faça login na plataforma AceData Cloud
  2. Vá para a página Suno Audios API
  3. Clique em “Acquire” para obter o Token da API (primeira solicitação oferece crédito gratuito)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-suno

​
Método 2: Instalação a partir do código-fonte

git clone https://github.com/AceDataCloud/MCPSuno.git
cd MCPSuno
pip install -e .
Após a instalação, você pode usar o comando mcp-suno para iniciar o serviço.

​
Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalar pacotes previamente): 
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Após salvar a configuração, reinicie o Claude Desktop para usar as ferramentas relacionadas ao Suno nas conversas.

​
Usando no VS Code / Cursor

Crie um arquivo .vscode/mcp.json no diretório raiz do projeto: 
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}
Ou use uvx: 
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "seu Token da API"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
suno_generate_musicGeração de música através de prompts de texto
suno_generate_custom_musicGeração de música com letras e estilos personalizados
suno_extend_musicContinuação de canções a partir de um ponto específico
suno_cover_musicCriação de versões cover
suno_concat_musicJunção de trechos de canções
suno_generate_with_personaGeração de música usando um personagem vocal específico
suno_remaster_musicRemasterização de áudio
suno_stems_musicSeparação de faixas (vocal/acompanhamento)
suno_replace_sectionSubstituição de trechos específicos em canções
suno_upload_extendUpload de áudio e continuação
suno_upload_coverUpload de áudio e criação de cover
suno_mashup_musicMistura de várias canções
suno_generate_lyricsGeração de letras com base em descrições
suno_create_personaCriação de personagem vocal
suno_get_mp4Obtenção de vídeo MP4 da canção
suno_get_timingObtenção da linha do tempo das letras
suno_extract_vocalsExtração de vocais
suno_get_wavObtenção de WAV de alta qualidade
suno_get_midiObtenção de arquivo MIDI
suno_optimize_styleOtimização de etiquetas de estilo musical
suno_mashup_lyricsMistura de letras
suno_upload_audioUpload de áudio personalizado
suno_get_taskConsulta de status de uma única tarefa
suno_get_tasks_batchConsulta em lote de status de tarefas

​
Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:
  • “Ajude-me a gerar uma música pop sobre o verão”
  • “Faça um cover desta música em estilo jazz”
  • “Continue esta música a partir dos 30 segundos”
  • “Gere uma letra em chinês com o tema de viagem”
  • “Separe a voz desta música”
  • “Ajude-me a converter esta música para o formato MIDI”

​
Mais Informações