Suno MCP Przewodnik Integracji

MCP (Model Context Protocol) 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:

Zarejestruj się lub zaloguj na platformie XHuoAPI
Przejdź do strony Suno Audios API
Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

Instalacja i konfiguracja

Metoda 1: Instalacja pip (zalecana)

pip install mcp-suno

Metoda 2: Instalacja ze źródła

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ę:

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}

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

{
  "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:

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}

Lub użyj uvx:

{
  "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
Pakiet PyPI: mcp-suno
Dokumentacja API: Suno API do generowania muzyki

Documentation Index

​Przegląd funkcji

​Wymagania wstępne

​Instalacja i konfiguracja

​Metoda 1: Instalacja pip (zalecana)

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

​Użycie w Claude Desktop

​Użycie w VS Code / Cursor

​Lista dostępnych narzędzi

​Przykłady użycia

​Więcej informacji