Suno MCP

Ein MCP-Server (Model Context Protocol) zum Generieren von Musik mit Suno.

Funktionen

• Songs generieren mit eigenen Texten und Style-Tags

• Aus Beschreibung generieren – lassen Sie Suno AI die Texte schreiben

• Auf Fertigstellung warten und Audio-URLs mit Markdown-Einbettungen erhalten

• MP3s herunterladen in lokale Ordner

• Token automatisch aktualisieren, wenn sie ablaufen

Related MCP server: Suno-MCP

Anforderungen

• Node.js 18+

• BrowserOS (oder ein beliebiges Chromium mit --remote-debugging-port) auf http://localhost:9100 mit angemeldetem Suno. Überschreiben mit CDP_URL.

• Ein Suno-Konto (kostenlos oder kostenpflichtig)

Installation

npm install

Verwendung mit Claude Code

Fügen Sie dies zu Ihrer .mcp.json hinzu:

{
  "suno": {
    "command": "node",
    "args": ["/path/to/suno-mcp/src/index.js"]
  }
}

Tools

Funktionsweise

Authentifizierung

Suno verwendet Clerk für die Authentifizierung mit kurzlebigen JWT-Token. Der Client ruft window.Clerk.session.getToken() im aktiven Suno-Tab über CDP auf – Clerk übernimmt die Aktualisierung im Hintergrund, sodass kein Neuladen der Seite erforderlich ist. Das Token wird bis 5 Minuten vor seinem exp-Claim zwischengespeichert.

Song-Generierung

Direkte API-Aufrufe schlagen aufgrund von hCaptcha fehl. Anstatt Formular-Selektoren zu scrapen, steuert der Client die eigene React-App von Suno:

1. Verbindung zum Suno-Tab über CDP herstellen; bei Bedarf zu /create navigieren.

2. Den React-Fiber-Baum vom „Create“-Button aus durchlaufen, um die Komponente zu finden, die onCreateClick / lyrics / styles / mode als Props bereitstellt – den semantischen Generierungs-Handler.

3. Textbereiche für Lyrics + Style mithilfe des React-kompatiblen nativen Setters befüllen, damit der interne Status aktualisiert wird.

4. Warten, bis die Props des Fibers die neuen Werte widerspiegeln (d. h. React wurde neu gerendert).

5. Einen vertrauenswürdigen Mausklick über CDP Input.dispatchMouseEvent an den Koordinaten des Buttons auslösen. hCaptcha akzeptiert CDP-synthetisierte Ereignisse als echte Benutzergesten (der Aufruf von onCreateClick() über JS funktioniert nicht – das Captcha verweigert dies).

6. Die /api/generate/v2-Antwort über CDP Network-Ereignisse erfassen, um die neuen Clip-IDs zurückzugeben. Fällt auf das Polling von /api/project/default zurück, falls das Netzwerkereignis verpasst wird.

Dieser Ansatz ist robust gegenüber UI-Neugestaltungen: Er hängt von semantischen React-Props (onCreateClick, lyrics, styles) und dem aria-label="Create song"-Button ab – beides sind tragende Elemente, die sich wahrscheinlich nicht ändern werden –, anstatt von Klassennamen, textContent-Übereinstimmungen oder dem DOM-Layout.

Beispiel

// Generate a song
const result = await suno_generate_song({
  lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test",
  style: "indie folk, acoustic, male vocals"
});

// Wait for it to complete
const songs = await suno_wait_for_songs({
  ids: result.songIds
});

// Download it
await suno_download_song({
  songId: songs[0].id,
  folder: "./downloads"
});

Bekannte Einschränkungen

• Das Titelfeld funktioniert nicht zuverlässig (Einschränkung der Suno-UI – derzeit nicht über den neuen Generierungspfad angebunden).

• generate_from_description (einfacher Modus) fällt derzeit auf den benutzerdefinierten Modus zurück, wenn der UI-Modus-Umschalter nicht gefunden wird; übergeben Sie Lyrics + Style über generate_song für deterministisches Verhalten.

• Erfordert BrowserOS mit einer aktiven, sichtbaren Suno-Sitzung. Der „Create“-Button muss auf dem Bildschirm eine Größe ungleich Null haben, damit der vertrauenswürdige Klick registriert wird.

• Das Token läuft etwa alle 1 Stunde ab (automatische Aktualisierung über Clerk).

Lizenz

MIT