> ## 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 Przewodnik Integracji

> suno MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki Suno MCP Server dostarczonemu przez XHuoAPI, możesz bezpośrednio generować muzykę, teksty piosenek i zarządzać projektami audio w klientach AI, takich jak Claude Desktop, VS Code, Cursor.

## Przegląd funkcji

Suno MCP Server oferuje następujące kluczowe funkcje:

* **Generowanie muzyki** — generowanie muzyki AI na podstawie tekstowych wskazówek
* **Tworzenie na zamówienie** — pełna kontrola nad tekstami, tytułami i stylami muzycznymi
* **Dopisywanie piosenek** — kontynuowanie istniejącej piosenki od dowolnego momentu
* **Covers/Miksowanie** — tworzenie wersji cover w różnych stylach
* **Generowanie tekstów** — generowanie zorganizowanych tekstów na podstawie opisu
* **Role głosowe** — zapisywanie i ponowne używanie stylów głosowych
* **Konwersja mediów** — uzyskiwanie MP4, WAV, MIDI, separacja głosu itp.
* **Optymalizacja stylu** — optymalizacja tagów stylu muzycznego
* **Zapytania o zadania** — monitorowanie postępu generacji i uzyskiwanie wyników

## Wymagania wstępne

Przed użyciem musisz uzyskać token API XHuoAPI:

1. Zarejestruj się lub zaloguj na [platformie XHuoAPI](https://api.xhuoapi.ai)
2. Przejdź do strony [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios)
3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: Instalacja pip (zalecana)

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

### Metoda 2: Instalacja ze źródła

```bash theme={null}
git clone https://github.com/XHuoAPI/SunoMCP.git
cd SunoMCP
pip install -e .
```

Po zakończeniu instalacji możesz użyć polecenia `mcp-suno`, aby uruchomić serwis.

## Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

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

Dodaj następującą konfigurację:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietu):

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi związanych z Suno w rozmowie.

## Użycie w VS Code / Cursor

Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia              | Opis                                                  |
| ---------------------------- | ----------------------------------------------------- |
| `suno_generate_music`        | Generowanie muzyki na podstawie tekstowych wskazówek  |
| `suno_generate_custom_music` | Generowanie muzyki z dostosowanymi tekstami i stylami |
| `suno_extend_music`          | Dopisywanie piosenki od określonego momentu           |
| `suno_cover_music`           | Tworzenie wersji cover                                |
| `suno_concat_music`          | Łączenie fragmentów piosenek                          |
| `suno_generate_with_persona` | Generowanie muzyki z użyciem określonej roli głosowej |
| `suno_remaster_music`        | Ponowne przetwarzanie mastera                         |
| `suno_stems_music`           | Separacja ścieżek (głos/akompaniament)                |
| `suno_replace_section`       | Zastępowanie określonych fragmentów piosenki          |
| `suno_upload_extend`         | Przesyłanie audio i dopisywanie                       |
| `suno_upload_cover`          | Przesyłanie audio i tworzenie coveru                  |
| `suno_mashup_music`          | Mieszanie wielu piosenek                              |
| `suno_generate_lyrics`       | Generowanie tekstów na podstawie opisu                |
| `suno_create_persona`        | Tworzenie roli głosowej                               |
| `suno_get_mp4`               | Uzyskiwanie wideo MP4 piosenki                        |
| `suno_get_timing`            | Uzyskiwanie osi czasu tekstów                         |
| `suno_extract_vocals`        | Ekstrakcja głosu                                      |
| `suno_get_wav`               | Uzyskiwanie wysokiej jakości WAV                      |
| `suno_get_midi`              | Uzyskiwanie pliku MIDI                                |
| `suno_optimize_style`        | Optymalizacja tagów stylu muzycznego                  |
| `suno_mashup_lyrics`         | Mieszanie tekstów                                     |
| `suno_upload_audio`          | Przesyłanie dostosowanego audio                       |
| `suno_get_task`              | Zapytanie o status pojedynczego zadania               |
| `suno_get_tasks_batch`       | Grupowe zapytanie o status zadań                      |

## Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:

* „Pomóż mi wygenerować piosenkę o lecie”
* „Zrób cover tej piosenki w stylu jazzowym”
* „Dopisz tę piosenkę, zaczynając od 30 sekundy”
* „Wygeneruj tekst piosenki w języku chińskim, temat to podróż”
* „Oddziel głos w tej piosence”
* „Pomóż mi przekonwertować tę piosenkę na format MIDI”

## Więcej informacji

* Repozytorium GitHub: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* Pakiet PyPI: [mcp-suno](https://pypi.org/project/mcp-suno/)
* Dokumentacja API: [Suno API do generowania muzyki](https://api.xhuoapi.ai/documents/suno)