Guide d'intégration Suno MCP

MCP (Model Context Protocol) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d’IA (comme Claude, GPT, etc.) d’appeler des outils externes via une interface standardisée. Grâce au serveur Suno MCP fourni par AceData Cloud, vous pouvez générer directement de la musique, des paroles et gérer des projets audio dans des clients IA tels que Claude Desktop, VS Code, Cursor, etc.

Vue d’ensemble des fonctionnalités

Le serveur Suno MCP offre les fonctionnalités principales suivantes :

Génération de musique — Générer de la musique IA à partir de mots-clés textuels
Création personnalisée — Contrôle total des paroles, titres et styles musicaux
Continuation de chansons — Prolonger une chanson existante à partir de n’importe quel point dans le temps
Covers / Remixes — Créer des versions de reprise dans différents styles
Génération de paroles — Générer des paroles structurées à partir de descriptions
Personnages vocaux — Sauvegarder et réutiliser des styles vocaux
Conversion de médias — Obtenir MP4, WAV, MIDI, séparation de voix, etc.
Optimisation de style — Optimiser les étiquettes de style musical
Requêtes de tâches — Surveiller l’avancement de la génération et obtenir des résultats

Préparations préalables

Avant d’utiliser, vous devez obtenir un jeton API AceData Cloud :

Inscrivez-vous ou connectez-vous à la plateforme AceData Cloud
Allez à la page Suno Audios API
Cliquez sur « Acquire » pour obtenir un jeton API (première demande avec un quota gratuit)

Installation et configuration

Méthode 1 : Installation avec pip (recommandée)

pip install mcp-suno

Méthode 2 : Installation à partir du code source

git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
pip install -e .

Une fois l’installation terminée, vous pouvez utiliser la commande mcp-suno pour démarrer le service.

Utilisation dans Claude Desktop

Éditez le fichier de configuration de Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez la configuration suivante :

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}

Si vous utilisez uvx (pas besoin d’installer le paquet à l’avance) :

{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}

Après avoir enregistré la configuration, redémarrez Claude Desktop pour pouvoir utiliser les outils Suno dans la conversation.

Utilisation dans VS Code / Cursor

Créez un fichier .vscode/mcp.json dans le répertoire racine du projet :

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}

Ou utilisez uvx :

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}

Liste des outils disponibles

Nom de l’outil	Description
`suno_generate_music`	Générer de la musique à partir de mots-clés textuels
`suno_generate_custom_music`	Générer de la musique avec des paroles et un style personnalisés
`suno_extend_music`	Continuer une chanson à partir d’un point spécifié
`suno_cover_music`	Créer une version de reprise
`suno_concat_music`	Assembler des segments de chansons
`suno_generate_with_persona`	Générer de la musique avec un personnage vocal spécifié
`suno_remaster_music`	Remasteriser la musique
`suno_stems_music`	Séparer les pistes (voix/accompagnement)
`suno_replace_section`	Remplacer un segment spécifié dans une chanson
`suno_upload_extend`	Télécharger de l’audio et continuer
`suno_upload_cover`	Télécharger de l’audio et faire une reprise
`suno_mashup_music`	Mixer plusieurs chansons
`suno_generate_lyrics`	Générer des paroles à partir de descriptions
`suno_create_persona`	Créer un personnage vocal
`suno_get_mp4`	Obtenir la vidéo MP4 de la chanson
`suno_get_timing`	Obtenir la chronologie des paroles
`suno_extract_vocals`	Extraire les voix
`suno_get_wav`	Obtenir un WAV de haute qualité
`suno_get_midi`	Obtenir un fichier MIDI
`suno_optimize_style`	Optimiser les étiquettes de style musical
`suno_mashup_lyrics`	Mixer des paroles
`suno_upload_audio`	Télécharger de l’audio personnalisé
`suno_get_task`	Vérifier l’état d’une tâche unique
`suno_get_tasks_batch`	Vérifier l’état des tâches par lot

Exemples d’utilisation

Une fois la configuration terminée, vous pouvez appeler ces fonctionnalités directement en langage naturel dans le client IA, par exemple :

« Aide-moi à générer une chanson pop sur l’été »
« Fais une reprise de cette chanson dans un style jazz »
« Continue cette chanson à partir de 30 secondes »
« Génère des paroles en chinois sur le thème du voyage »
« Sépare la voix de cette chanson »
« Aide-moi à convertir cette chanson en format MIDI »

Plus d’informations

Dépôt GitHub : AceDataCloud/SunoMCP
Paquet PyPI : mcp-suno
Documentation API : API de génération de musique Suno

​Vue d’ensemble des fonctionnalités

​Préparations préalables

​Installation et configuration

​Méthode 1 : Installation avec pip (recommandée)

​Méthode 2 : Installation à partir du code source

​Utilisation dans Claude Desktop

​Utilisation dans VS Code / Cursor

​Liste des outils disponibles

​Exemples d’utilisation

​Plus d’informations