> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno MCP Integrationsanleitung

> suno MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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 XHuoAPI 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 XHuoAPI API Token erhalten:

1. Registriere dich oder melde dich bei der [XHuoAPI Plattform](https://api.xhuoapi.ai) an
2. Gehe zur Seite [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios)
3. 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)

```bash theme={null}
pip install mcp-suno
```

### Methode 2: Quellcode-Installation

```bash theme={null}
git clone https://github.com/XHuoAPI/SunoMCP.git
cd SunoMCP
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:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Wenn du `uvx` verwendest (keine vorherige Installation erforderlich):

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Oder verwende `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* PyPI-Paket: [mcp-suno](https://pypi.org/project/mcp-suno/)
* API-Dokumentation: [Suno Musikgenerierungs-API](https://api.xhuoapi.ai/documents/suno)