Suno MCP Integrationsanleitung

MCP (Model Context Protocol) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Werkzeuge über standardisierte Schnittstellen aufzurufen. Über den von AceData Cloud bereitgestellten Suno MCP Server kannst du direkt in AI-Clients wie Claude Desktop, VS Code, Cursor Musik, Texte und Audio-Projekte verwalten.

Funktionsübersicht

Der Suno MCP Server bietet folgende Kernfunktionen:

Musikgenerierung — KI-Musik durch Texteingaben generieren
Benutzerdefinierte Kreation — Vollständige Kontrolle über Texte, Titel und Musikstil
Songfortsetzung — Fortsetzung eines bestehenden Songs ab einem beliebigen Zeitpunkt
Cover/Mixing — Erstellen von Coverversionen in verschiedenen Stilen
Textgenerierung — Strukturierte Texte basierend auf Beschreibungen generieren
Stimmenrollen — Stimmenstile speichern und wiederverwenden
Medienkonvertierung — Erhalten von MP4, WAV, MIDI, Stimmtrennung usw.
Stiloptimierung — Optimierung von Musikstil-Tags
Aufgabenabfrage — Überwachung des Generierungsfortschritts und Abruf von Ergebnissen

Vorbereitungen

Vor der Nutzung musst du ein AceData Cloud API Token erhalten:

Registriere dich oder melde dich bei der AceData Cloud Plattform an
Gehe zur Seite Suno Audios API
Klicke auf „Acquire“, um ein API Token zu erhalten (bei der ersten Anfrage gibt es ein kostenloses Kontingent)

Installation und Konfiguration

Methode 1: pip Installation (empfohlen)

pip install mcp-suno

Methode 2: Quellcode-Installation

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

Nach der Installation kannst du den Dienst mit dem Befehl mcp-suno starten.

Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

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

Füge die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Wenn du uvx verwendest (keine vorherige Installation erforderlich):

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

Speichere die Konfiguration und starte Claude Desktop neu, um die Suno-Tools im Dialog zu verwenden.

Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei .vscode/mcp.json:

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}

Oder verwende uvx:

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

Verfügbare Werkzeugliste

Werkzeugname	Beschreibung
`suno_generate_music`	Musik durch Texteingaben generieren
`suno_generate_custom_music`	Musik mit benutzerdefinierten Texten und Stilen generieren
`suno_extend_music`	Fortsetzung eines Songs ab einem bestimmten Zeitpunkt
`suno_cover_music`	Erstellen von Coverversionen
`suno_concat_music`	Zusammenfügen von Musikstücken
`suno_generate_with_persona`	Musik mit einer bestimmten Stimmenrolle generieren
`suno_remaster_music`	Neu abmischen
`suno_stems_music`	Trennen von Spuren (Gesang/Instrumental)
`suno_replace_section`	Ersetzen eines bestimmten Abschnitts im Song
`suno_upload_extend`	Audio hochladen und fortsetzen
`suno_upload_cover`	Audio hochladen und covern
`suno_mashup_music`	Mischen mehrerer Songs
`suno_generate_lyrics`	Texte basierend auf Beschreibungen generieren
`suno_create_persona`	Stimmenrolle erstellen
`suno_get_mp4`	MP4-Video des Songs erhalten
`suno_get_timing`	Zeitachse der Texte erhalten
`suno_extract_vocals`	Gesang extrahieren
`suno_get_wav`	Hochwertige WAV erhalten
`suno_get_midi`	MIDI-Datei erhalten
`suno_optimize_style`	Musikstil-Tags optimieren
`suno_mashup_lyrics`	Texte mischen
`suno_upload_audio`	Benutzerdefiniertes Audio hochladen
`suno_get_task`	Status einer einzelnen Aufgabe abfragen
`suno_get_tasks_batch`	Status mehrerer Aufgaben abfragen

Anwendungsbeispiele

Nach der Konfiguration kannst du diese Funktionen direkt in den AI-Clients mit natürlicher Sprache aufrufen, zum Beispiel:

„Hilf mir, einen Popsong über den Sommer zu generieren“
„Mach ein Jazz-Cover von diesem Lied“
„Setze diesen Song ab der 30. Sekunde fort“
„Generiere einen Songtext auf Chinesisch mit dem Thema Reisen“
„Trenne den Gesang von diesem Lied“
„Hilf mir, dieses Lied in das MIDI-Format zu konvertieren“

Weitere Informationen

GitHub-Repository: AceDataCloud/MCPSuno
PyPI-Paket: mcp-suno
API-Dokumentation: Suno Musikgenerierungs-API

MCP-Server

​Funktionsübersicht

​Vorbereitungen

​Installation und Konfiguration

​Methode 1: pip Installation (empfohlen)

​Methode 2: Quellcode-Installation

​Verwendung in Claude Desktop

​Verwendung in VS Code / Cursor

​Verfügbare Werkzeugliste

​Anwendungsbeispiele

​Weitere Informationen