Guide d'intégration Suno MCP

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 :

1. Inscrivez-vous ou connectez-vous à la plateforme AceData Cloud
2. Allez à la page Suno Audios API
3. 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/MCPSuno.git
cd MCPSuno
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/MCPSuno
• Paquet PyPI : mcp-suno
• Documentation API : API de génération de musique Suno