> ## 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 інтеграційний посібник

> suno MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — це протокол контексту моделі, представлений компанією Anthropic, який дозволяє AI моделям (таким як Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. Завдяки Suno MCP Server, наданому XHuoAPI, ви можете безпосередньо генерувати музику, тексти пісень та керувати аудіопроектами в таких AI-клієнтах, як Claude Desktop, VS Code, Cursor тощо.

## Огляд функцій

Suno MCP Server надає такі основні функції:

* **Генерація музики** — створення AI-музики за текстовими підказками
* **Кастомізоване створення** — повний контроль над текстами, заголовками та музичними стилями
* **Продовження пісень** — продовження вже існуючих пісень з будь-якої точки
* **Кавер/мікс** — створення кавер-версій в різних стилях
* **Генерація текстів** — створення структурованих текстів на основі опису
* **Голосові ролі** — збереження та повторне використання стилів голосу
* **Медіа конвертація** — отримання MP4, WAV, MIDI, відокремлення голосу тощо
* **Оптимізація стилю** — оптимізація тегів музичного стилю
* **Запит завдань** — моніторинг прогресу генерації та отримання результатів

## Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:

1. Зареєструйтесь або увійдіть на [платформу XHuoAPI](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios)
3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

## Встановлення та налаштування

### Спосіб перший: установка через pip (рекомендується)

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

### Спосіб другий: установка з вихідного коду

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

Після завершення установки ви можете використовувати команду `mcp-suno` для запуску сервісу.

## Використання в Claude Desktop

Редагуйте конфігураційний файл Claude Desktop:

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

Додайте наступну конфігурацію:

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

Якщо ви використовуєте `uvx` (не потрібно попередньо встановлювати пакет):

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб використовувати інструменти Suno в діалозі.

## Використання в VS Code / Cursor

У кореневій директорії проекту створіть `.vscode/mcp.json`:

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

Або використовуйте `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

## Доступний список інструментів

| Назва інструменту            | Опис                                                    |
| ---------------------------- | ------------------------------------------------------- |
| `suno_generate_music`        | Генерація музики за текстовими підказками               |
| `suno_generate_custom_music` | Генерація музики з кастомізованими текстами та стилями  |
| `suno_extend_music`          | Продовження пісні з вказаної точки                      |
| `suno_cover_music`           | Створення кавер-версії                                  |
| `suno_concat_music`          | З'єднання фрагментів пісень                             |
| `suno_generate_with_persona` | Генерація музики з використанням заданої голосової ролі |
| `suno_remaster_music`        | Перемастеринг                                           |
| `suno_stems_music`           | Відокремлення треків (голос/інструменти)                |
| `suno_replace_section`       | Заміна вказаного фрагмента в пісні                      |
| `suno_upload_extend`         | Завантаження аудіо та продовження                       |
| `suno_upload_cover`          | Завантаження аудіо та каверування                       |
| `suno_mashup_music`          | Міксування кількох пісень                               |
| `suno_generate_lyrics`       | Генерація текстів на основі опису                       |
| `suno_create_persona`        | Створення голосової ролі                                |
| `suno_get_mp4`               | Отримання MP4 відео пісні                               |
| `suno_get_timing`            | Отримання таймінгу текстів                              |
| `suno_extract_vocals`        | Витягування голосу                                      |
| `suno_get_wav`               | Отримання високоякісного WAV                            |
| `suno_get_midi`              | Отримання MIDI файлу                                    |
| `suno_optimize_style`        | Оптимізація тегів музичного стилю                       |
| `suno_mashup_lyrics`         | Міксування текстів                                      |
| `suno_upload_audio`          | Завантаження кастомізованого аудіо                      |
| `suno_get_task`              | Запит статусу одного завдання                           |
| `suno_get_tasks_batch`       | Пакетний запит статусів завдань                         |

## Приклади використання

Після налаштування ви можете безпосередньо викликати ці функції в AI-клієнті, використовуючи природну мову, наприклад:

* «Допоможи мені створити пісню про літо»
* «Зроби кавер на цю пісню в джазовому стилі»
* «Продовж цю пісню, починаючи з 30 секунди»
* «Згенеруй текст пісні китайською мовою на тему подорожей»
* «Відокреми голос з цієї пісні»
* «Допоможи мені перетворити цю пісню в формат MIDI»

## Додаткова інформація

* Репозиторій GitHub: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* Пакет PyPI: [mcp-suno](https://pypi.org/project/mcp-suno/)
* Документація API: [Suno API для генерації музики](https://api.xhuoapi.ai/documents/suno)