Suno MCP интеграционное руководство

MCP (Model Context Protocol) — это протокол контекста модели, разработанный Anthropic, который позволяет AI моделям (таким как Claude, GPT и др.) вызывать внешние инструменты через стандартизированный интерфейс. С помощью Suno MCP Server, предоставляемого AceData Cloud, вы можете напрямую генерировать музыку, тексты песен и управлять аудиопроектами в таких AI-клиентах, как Claude Desktop, VS Code, Cursor и др.

Обзор функций

Suno MCP Server предоставляет следующие основные функции:

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

Предварительная подготовка

Перед использованием вам необходимо получить AceData Cloud API Token:

Зарегистрируйтесь или войдите на платформу AceData Cloud
Перейдите на страницу Suno Audios API
Нажмите «Acquire», чтобы получить API Token (первый запрос предоставляет бесплатный лимит)

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

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

pip install mcp-suno

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

git clone https://github.com/AceDataCloud/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

Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Если вы используете uvx (не требует предварительной установки пакета):

{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Сохраните конфигурацию и перезапустите Claude Desktop, чтобы использовать инструменты Suno в диалоге.

Использование в VS Code / Cursor

Создайте файл .vscode/mcp.json в корневом каталоге проекта:

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "ваш API Token"
      }
    }
  }
}

Или используйте uvx:

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_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: AceDataCloud/SunoMCP
Пакет PyPI: mcp-suno
Документация API: API генерации музыки Suno

​Обзор функций

​Предварительная подготовка

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

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

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

​Использование в Claude Desktop

​Использование в VS Code / Cursor

​Список доступных инструментов

​Примеры использования

​Дополнительная информация