Suno MCP інтеграційний посібник

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

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

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

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

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

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

Зареєструйтесь або увійдіть на платформу XHuoAPI
Перейдіть на сторінку Suno Audios API
Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

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

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

pip install mcp-suno

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

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

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

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

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

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

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

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

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

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

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

{
  "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
Пакет PyPI: mcp-suno
Документація API: Suno API для генерації музики

Documentation Index

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

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

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

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

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

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

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

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

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

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