Перейти к основному содержанию
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:
  1. Зарегистрируйтесь или войдите на платформу AceData Cloud
  2. Перейдите на страницу Suno Audios API
  3. Нажмите «Acquire», чтобы получить API Token (первый запрос предоставляет бесплатный лимит)

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

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

pip install mcp-suno

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

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

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