Suno MCP

Сервер MCP (Model Context Protocol) для создания музыки с помощью Suno.

Функции

• Генерация песен с собственными текстами и тегами стиля

• Генерация по описанию — позвольте ИИ Suno написать текст

• Ожидание завершения и получение URL-адресов аудио с вставками markdown

• Скачивание MP3 в локальные папки

• Автоматическое обновление токенов по истечении срока их действия

Related MCP server: Suno-MCP

Требования

• Node.js 18+

• BrowserOS (или любой Chromium с параметром --remote-debugging-port) на http://localhost:9100 с выполненным входом в Suno. Переопределяется через CDP_URL.

• Учетная запись Suno (бесплатная или платная)

Установка

npm install

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

Добавьте в ваш .mcp.json:

{
  "suno": {
    "command": "node",
    "args": ["/path/to/suno-mcp/src/index.js"]
  }
}

Инструменты

Как это работает

Аутентификация

Suno использует Clerk для аутентификации с короткоживущими JWT-токенами. Клиент вызывает window.Clerk.session.getToken() во вкладке с открытым Suno через CDP — Clerk обрабатывает обновление в фоновом режиме, поэтому перезагрузка страницы не требуется. Токен кэшируется до момента за 5 минут до истечения его срока действия (exp).

Генерация песен

Прямые вызовы API завершаются ошибкой из-за hCaptcha. Вместо парсинга селекторов форм, клиент управляет собственным React-приложением Suno:

1. Подключается к вкладке Suno через CDP; при необходимости переходит на /create.

2. Проходит по дереву React fiber от кнопки «Создать» (Create), чтобы найти компонент, который предоставляет onCreateClick / lyrics / styles / mode в качестве пропсов — семантический обработчик генерации.

3. Заполняет текстовые поля для текста и стиля, используя нативный сеттер, совместимый с React, чтобы обновилось внутреннее состояние.

4. Ожидает, пока пропсы fiber не отразят новые значения (т.е. React выполнил повторный рендеринг).

5. Отправляет доверенный клик мышью через Input.dispatchMouseEvent в CDP по координатам кнопки. hCaptcha принимает синтезированные CDP события как реальные жесты пользователя (вызов onCreateClick() из JS не работает — капча отклоняет его).

6. Перехватывает ответ /api/generate/v2 через события Network в CDP, чтобы вернуть новые ID клипов. Если событие сети пропущено, выполняется опрос /api/project/default.

Этот подход устойчив к изменениям дизайна интерфейса: он зависит от семантических пропсов React (onCreateClick, lyrics, styles) и кнопки aria-label="Create song" — оба этих элемента являются ключевыми и вряд ли изменятся — а не от имен классов, совпадений текстового содержимого или структуры DOM.

Пример

// Generate a song
const result = await suno_generate_song({
  lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test",
  style: "indie folk, acoustic, male vocals"
});

// Wait for it to complete
const songs = await suno_wait_for_songs({
  ids: result.songIds
});

// Download it
await suno_download_song({
  songId: songs[0].id,
  folder: "./downloads"
});

Известные ограничения

• Поле заголовка работает нестабильно (ограничение интерфейса Suno — в настоящее время не подключено к новому пути генерации).

• generate_from_description (простой режим) в настоящее время переключается на пользовательский режим, если переключатель режима в интерфейсе не найден; для детерминированного поведения передавайте текст и стиль через generate_song.

• Требуется BrowserOS с активной, видимой сессией Suno. Кнопка «Создать» должна иметь ненулевой размер на экране, чтобы доверенный клик сработал.

• Токен истекает примерно через 1 час (автоматически обновляется через Clerk).

Лицензия

MIT