Vai al contenuto principale
MCP (Model Context Protocol) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Suno MCP Server fornito da AceData Cloud, puoi generare direttamente musica, testi e gestire progetti audio in client AI come Claude Desktop, VS Code, Cursor, ecc.

​
Panoramica delle funzionalità

Il Suno MCP Server offre le seguenti funzionalità principali:
  • Generazione musicale — Genera musica AI tramite suggerimenti testuali
  • Creazione personalizzata — Controllo completo su testi, titoli e stili musicali
  • Continuazione di canzoni — Estendi una canzone esistente da qualsiasi punto temporale
  • Cover/Mixing — Crea versioni cover in stili diversi
  • Generazione di testi — Genera testi strutturati in base a descrizioni
  • Ruoli vocali — Salva e riutilizza stili vocali
  • Conversione media — Ottieni MP4, WAV, MIDI, separazione delle voci, ecc.
  • Ottimizzazione dello stile — Ottimizza le etichette di stile musicale
  • Query di attività — Monitora il progresso della generazione e ottieni risultati

​
Preparazione preliminare

Prima di utilizzare, devi ottenere il Token API di AceData Cloud:
  1. Registrati o accedi alla piattaforma AceData Cloud
  2. Vai alla pagina Suno Audios API
  3. Clicca su “Acquire” per ottenere il Token API (il primo acquisto include un credito gratuito)

​
Installazione e configurazione

​
Metodo 1: installazione pip (consigliato)

pip install mcp-suno

​
Metodo 2: installazione da sorgente

git clone https://github.com/AceDataCloud/MCPSuno.git
cd MCPSuno
pip install -e .
Dopo l’installazione, puoi avviare il servizio utilizzando il comando mcp-suno.

​
Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Aggiungi la seguente configurazione: 
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Se utilizzi uvx (non è necessario installare pacchetti in anticipo): 
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti correlati a Suno nella conversazione.

​
Utilizzo in VS Code / Cursor

Crea un file .vscode/mcp.json nella directory principale del progetto: 
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
Oppure utilizza uvx: 
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

​
Elenco degli strumenti disponibili

Nome dello strumentoDescrizione
suno_generate_musicGenera musica tramite suggerimenti testuali
suno_generate_custom_musicGenera musica con testi e stili personalizzati
suno_extend_musicEstendi una canzone da un punto temporale specificato
suno_cover_musicCrea versioni cover
suno_concat_musicUnisci frammenti di canzoni
suno_generate_with_personaGenera musica utilizzando un ruolo vocale specificato
suno_remaster_musicRielabora il master
suno_stems_musicSepara le tracce (voce/strumenti)
suno_replace_sectionSostituisci un segmento specifico di una canzone
suno_upload_extendCarica audio e continua la scrittura
suno_upload_coverCarica audio e crea una cover
suno_mashup_musicCombina più canzoni
suno_generate_lyricsGenera testi in base a descrizioni
suno_create_personaCrea un ruolo vocale
suno_get_mp4Ottieni video MP4 della canzone
suno_get_timingOttieni la timeline dei testi
suno_extract_vocalsEstrai la voce
suno_get_wavOttieni WAV di alta qualità
suno_get_midiOttieni file MIDI
suno_optimize_styleOttimizza le etichette di stile musicale
suno_mashup_lyricsCombina testi
suno_upload_audioCarica audio personalizzato
suno_get_taskControlla lo stato di un singolo compito
suno_get_tasks_batchControlla lo stato di più compiti

​
Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nei client AI, ad esempio:
  • “Aiutami a generare una canzone pop sull’estate”
  • “Fai una cover di questa canzone in stile jazz”
  • “Continua questa canzone, partendo dal 30° secondo”
  • “Genera un testo in cinese, il tema è il viaggio”
  • “Separa la voce da questa canzone”
  • “Aiutami a convertire questa canzone in formato MIDI”

​
Maggiori informazioni