> ## 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 (первый запрос предоставляет бесплатный лимит)

## Установка и настройка

### Способ 1: установка через pip (рекомендуется)

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

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

```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: [API генерации музыки Suno](https://api.xhuoapi.ai/documents/suno)