Guida all'integrazione di Suno MCP

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 XHuoAPI, 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 XHuoAPI:

Registrati o accedi alla piattaforma XHuoAPI
Vai alla pagina Suno Audios API
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/XHuoAPI/SunoMCP.git
cd SunoMCP
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": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Se utilizzi uvx (non è necessario installare pacchetti in anticipo):

{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Oppure utilizza uvx:

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}

Elenco degli strumenti disponibili

Nome dello strumento	Descrizione
`suno_generate_music`	Genera musica tramite suggerimenti testuali
`suno_generate_custom_music`	Genera musica con testi e stili personalizzati
`suno_extend_music`	Estendi una canzone da un punto temporale specificato
`suno_cover_music`	Crea versioni cover
`suno_concat_music`	Unisci frammenti di canzoni
`suno_generate_with_persona`	Genera musica utilizzando un ruolo vocale specificato
`suno_remaster_music`	Rielabora il master
`suno_stems_music`	Separa le tracce (voce/strumenti)
`suno_replace_section`	Sostituisci un segmento specifico di una canzone
`suno_upload_extend`	Carica audio e continua la scrittura
`suno_upload_cover`	Carica audio e crea una cover
`suno_mashup_music`	Combina più canzoni
`suno_generate_lyrics`	Genera testi in base a descrizioni
`suno_create_persona`	Crea un ruolo vocale
`suno_get_mp4`	Ottieni video MP4 della canzone
`suno_get_timing`	Ottieni la timeline dei testi
`suno_extract_vocals`	Estrai la voce
`suno_get_wav`	Ottieni WAV di alta qualità
`suno_get_midi`	Ottieni file MIDI
`suno_optimize_style`	Ottimizza le etichette di stile musicale
`suno_mashup_lyrics`	Combina testi
`suno_upload_audio`	Carica audio personalizzato
`suno_get_task`	Controlla lo stato di un singolo compito
`suno_get_tasks_batch`	Controlla 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

Repository GitHub: XHuoAPI/SunoMCP
Pacchetto PyPI: mcp-suno
Documentazione API: API di generazione musicale Suno

Documentation Index

​Panoramica delle funzionalità

​Preparazione preliminare

​Installazione e configurazione

​Metodo 1: installazione pip (consigliato)

​Metodo 2: installazione da sorgente

​Utilizzo in Claude Desktop

​Utilizzo in VS Code / Cursor

​Elenco degli strumenti disponibili

​Esempi di utilizzo

​Maggiori informazioni