AceDataCloud/MCPSuno

AceDataCloud/MCPSuno

от acedatacloud
MCP сервер для генерации музыки с ИИ через Suno и AceDataCloud. Создавайте песни, управляйте текстами и стилями, расширяйте треки, извлекайте вокал — всё через Claude или другие MCP-клиенты. Полезе...

SunoMCP

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for AI music generation using Suno through the AceDataCloud API.

Generate AI music, lyrics, and manage audio projects directly from Claude, VS Code, or any MCP-compatible client.

Features

  • Music Generation - Create AI-generated songs from text prompts
  • Custom Lyrics & Style - Full control over lyrics, title, and music style
  • Song Extension - Continue existing songs from any timestamp
  • Cover/Remix - Create cover versions with different styles
  • Lyrics Generation - Generate structured lyrics from descriptions
  • Persona Management - Save and reuse voice styles
  • Task Tracking - Monitor generation progress and retrieve results

Tool Reference

Tool Description
suno_generate_music Generate AI music from a text prompt using Suno's Inspiration Mode.
suno_generate_custom_music Generate AI music with full control over lyrics, title, and style (Custom Mode).
suno_extend_music Extend an existing song from a specific timestamp with new lyrics.
suno_cover_music Create a cover or remix version of an existing song in a different style.
suno_concat_music Concatenate extended song segments into a single complete audio file.
suno_generate_with_persona Generate music using a saved artist persona for consistent vocal style.
suno_remaster_music Remaster an existing song to improve audio quality.
suno_stems_music Separate a song into individual stems (vocals and instruments).
suno_replace_section Replace a specific time range in a song with new generated content.
suno_upload_extend Extend an uploaded audio (your own music) with new AI-generated content.
suno_upload_cover Create an AI cover of an uploaded audio (your own music).
suno_mashup_music Create a musical mashup by blending multiple songs together.
suno_generate_lyrics Generate song lyrics from a text prompt.
suno_get_mp4 Get an MP4 video version of a generated song.
suno_get_timing Get timing and subtitle data for a generated song.
suno_extract_vocals Extract the vocal track from a generated song (stem separation).
suno_get_wav Get the lossless WAV format of a generated song.
suno_get_midi Get MIDI data extracted from a generated song.
suno_create_persona Create a new artist persona from an existing audio's vocal style.
suno_optimize_style Optimize a music style description for better generation results.
suno_mashup_lyrics Generate mashup lyrics by combining two sets of lyrics.
suno_upload_audio Upload an external audio file to Suno for use in subsequent operations.
suno_get_task Query the status and result of a music generation task.
suno_get_tasks_batch Query multiple music generation tasks at once.
suno_list_models List all available Suno models and their capabilities.
suno_list_actions List all available Suno API actions and corresponding tools.
suno_get_lyric_format_guide Get guidance on formatting lyrics for Suno music generation.
Инструменты были проиндексированы:
suno_all_stems_music

Разделяет песню на все отдельные стемы (вокал, бас, ударные, другие инструменты). Разбивает аудио на несколько отдельных дорожек для всех компонентов, обеспечивая более детальное разделение на стемы, чем suno_stems_music. Сервис может вернуть два одноимённых набора из 12 стемов без метаданных, различающих эти наборы; оба набора сохраняются, чтобы ни один аудиофрагмент не был молча отброшен. Используйте это, когда: - Нужно полное разделение на многодорожечные стемы - Требуются дорожки отдельных инструментов для ремикширования - Нужно получить отдельно дорожки баса, ударных и других инструментов Возвращает: ID задачи и все результаты разделения на стемы с URL-адресами отдельных дорожек.

Параметры
  • audio_idstringобязательный

    ID of the audio to separate into all individual stems.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

suno_archive_custom_model

Archive a custom music model so it can no longer be used. Archiving does not guarantee that model capacity is released.

Параметры
  • idstringобязательный

    ID of the custom music model to archive.

suno_concat_music

Соединяет расширенные сегменты песни в единый полный аудиофайл. После многократного расширения песни с помощью suno_extend_music используйте этот инструмент, чтобы объединить все сегменты в один непрерывный аудиофайл. Используйте в таких случаях: - Вы расширили песню один или несколько раз - Вам нужен один аудиофайл вместо нескольких сегментов - Вы готовы завершить длинную композицию Возвращает: ID задачи и информацию о соединённом аудио с полной песней.

Параметры
  • audio_idstringобязательный

    ID of the LAST segment of an extended song chain. Suno will automatically find and merge all connected segments.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the concatenation is complete.

suno_cover_music

Создаёт кавер или ремикс-версию существующей песни в другом стиле. Генерирует новую версию песни с другой аранжировкой, жанром или настроением, сохраняя основную мелодию и текст. Используйте это, когда: - Хотите услышать песню в другом жанре - Хотите акустическую или unplugged-версию электронной песни - Хотите сделать ремикс песни с другой атмосферой Возвращает: ID задачи и информацию об аудиофайле кавера.

Параметры
  • audio_idstringобязательный

    ID of the audio to create a cover of. This is the 'id' field from a previous generation.

  • audio_weightnumber | null

    Advanced parameter for cover operations. Controls how much the original audio influences the cover generation.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the cover is complete.

  • modelenum

    Model version to use for the cover.

  • promptstring

    Description of how you want the cover to sound. Examples: 'acoustic unplugged version', 'jazz lounge style', '80s synthwave remix'

  • stylestring

    Target music style for the cover. Examples: 'jazz, smooth, saxophone', 'acoustic folk, gentle guitar', 'electronic dance, high energy'

suno_create_custom_model

Create a reusable custom music model from authorized audio examples. This is a paid, long-running operation. Call it only after the user confirms the source files and the 5.6-Credit list price.

Параметры
  • audio_urlsstring[]обязательный

    6 to 24 authorized audio URLs used to train the custom music model.

  • callback_urlstring | null

    Webhook callback URL for custom model creation status.

  • idempotency_keystring | null

    Optional Idempotency-Key header value for safe retries.

  • namestringобязательный

    Name for the custom music model.

suno_create_persona

Создаёт новый образ исполнителя на основе вокального стиля существующей аудиозаписи. Сохраняет вокальные характеристики сгенерированной песни, чтобы вы могли повторно использовать тот же голос в будущих генерациях. Отлично подходит для поддержания единообразия в нескольких песнях. Используйте это когда: - Вы сгенерировали песню и вам нравится голос - Вы хотите создать несколько песен с одним и тем же вокалистом - Вы собираете альбом с единым вокальным стилем - Вы хотите сохранить уникальный голос для будущего использования После создания образа используйте suno_generate_with_persona с возвращённым persona_id, чтобы генерировать новые песни с этим голосом. Возвращает: Persona ID, который можно использовать с инструментом suno_generate_with_persona.

Параметры
  • audio_idstringобязательный

    ID of the audio to use as the persona reference. This should be a previously generated song whose vocal style you want to save and reuse.

  • descriptionstring | null

    Description of the singer's style. Examples: 'Warm and breathy female voice with jazz influences', 'Powerful male rock vocalist with raspy tone'

  • namestringобязательный

    Name for this persona. Use a descriptive name that helps you remember the voice style. Examples: 'My Rock Voice', 'Soft Female Singer', 'Deep Male Baritone', 'Energetic Pop Vocalist'

  • vocal_endnumber | null

    End time in seconds of the vocal segment to use from the audio.

  • vocal_startnumber | null

    Start time in seconds of the vocal segment to use from the audio. Useful for isolating a specific vocal section.

  • vox_audio_idstring | null

    Optional audio ID used to generate a new singer's style by combining with the main audio. Useful for creating hybrid vocal personas.

suno_create_voice

Создаёт пользовательский голосовой персонаж из внешнего аудио-URL. Создаёт голосовой персонаж напрямую из публично доступного аудио-URL (MP3 или WAV). Аудио должно содержать чистый вокал одного диктора и быть длиной не менее 10 секунд. Отличается от suno_create_persona, который создаёт персонаж из ранее сгенерированного аудио Suno. Используйте этот инструмент, чтобы создать персонаж из собственных голосовых записей или внешних аудиофайлов. Используйте, когда: - У вас есть внешний аудиофайл с чистым вокалом - Вы хотите создать голосовой персонаж из собственных записей - Вы хотите использовать конкретный реальный голос в качестве персонажа Возвращает: ID персонажа, который можно использовать с инструментом suno_generate_with_persona.

Параметры
  • audio_urlstringобязательный

    Publicly accessible URL of the audio file to create a voice from. Must be MP3 or WAV format, at least 10 seconds long, containing clear vocals from a single speaker without background noise or music.

  • descriptionstring | null

    Description of the custom voice persona (optional).

  • namestring | null

    Optional name for the custom voice persona.

suno_delete_persona

Удалить сохраненную персону артиста. Удаляет навсегда ранее созданную персону. Это действие нельзя отменить. Используйте, когда: - Вы хотите удалить неиспользуемую голосовую персону - Вам нужно очистить старые персоны - Вы хотите удалить персону, которая больше не нужна Возвращает: Подтверждение удаления.

Параметры
  • persona_idstringобязательный

    The persona ID to delete.

  • user_idstring | null

    The user ID for ownership verification (optional).

suno_extend_music

Расширяет существующую песню с определённой временной метки новыми словами. Это позволяет продолжить ранее сгенерированную песню, добавляя новые части: дополнительные куплеты, бридж или аутро. Используйте это, когда: - Сгенерированная песня слишком короткая и вы хотите добавить больше - Вы хотите добавить бридж или аутро к существующей песне - Вы строите более длинную песню по частям После многократного расширения используйте suno_concat_music, чтобы объединить все отрезки. Возвращает: ID задачи и информацию о расширенном аудио.

Параметры
  • audio_idstringобязательный

    ID of the audio to extend. This is the 'id' field from a previous generation result.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the extension is complete.

  • continue_atnumberобязательный

    Timestamp in seconds where to start the extension. For example, 120.5 means continue from 2 minutes and 0.5 seconds into the song.

  • lyricstringобязательный

    Lyrics for the extended section. Use section markers like [Verse], [Chorus], [Bridge], [Outro]. The extension will continue from where the original song left off.

  • modelenum

    Model version to use for the extension.

  • stylestring

    Music style for the extension. Leave empty to maintain the original style, or specify to change the style mid-song.

suno_extract_vocals

Извлекает вокальную дорожку из сгенерированной песни (разделение по стемам). Изолирует вокал из песни, удаляя инструментальный фон. Полезен для ремиксов, создания акапельных версий или создания персонажа. Используйте это, когда: - Вы хотите получить изолированную вокальную дорожку - Вам нужен вокал для ремикса или мэшапа - Вы хотите создать персонажа из определённых вокальных сегментов Возвращает: Идентификатор задачи и информацию об извлечённом вокале.

Параметры
  • audio_idstringобязательный

    The song ID to extract vocals from.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • vocal_endnumberобязательный

    Required extraction end time in seconds. It must be greater than vocal_start, with a range shorter than 30 seconds.

  • vocal_startnumberобязательный

    Required extraction start time in seconds. The selected range must be shorter than 30 seconds.

suno_generate_custom_music

Генерирует музыку с помощью ИИ с полным контролем над текстом, названием и стилем (Custom Mode). Это даёт вам полный творческий контроль над песней. Вы предоставляете текст с маркерами разделов, а Suno генерирует мелодию и аранжировку. Используйте это, когда: - У вас есть конкретный текст, который вы хотите использовать - Вы хотите точно контролировать музыкальный стиль - Вам нужно конкретное название песни - Вы хотите указать пол вокала (модели v4.5+) - Вы хотите, чтобы API автоматически сгенерировал текст по запросу (используйте lyric_prompt) - Вам нужна конкретная длина трека (используйте duration) Для быстрой генерации без написания текста используйте suno_generate_music. Возвращает: Идентификатор задачи и сгенерированную аудиоинформацию, включая URL-адреса, название, текст и длительность.

Параметры
  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.

  • durationinteger | null

    Target length of the generated track in seconds, an integer between 10 and 360. Only takes effect for the 'generate' action in custom mode with model 'chirp-v5-5'; other combinations return a 400 error. The finished track lands near this value but is not guaranteed to match it exactly.

  • instrumentalboolean

    If true, generate instrumental version (lyrics will be ignored). Default is false.

  • lyricstring

    Song lyrics with section markers. Use [Verse], [Chorus], [Pre-Chorus], [Bridge], [Outro], [Intro] to structure the song. Example: [Verse 1] Walking down the empty street Rain is falling at my feet [Chorus] But I keep moving on Until the break of dawn. Leave empty when using lyric_prompt to auto-generate lyrics.

  • lyric_promptstring | null

    Prompt text for auto-generating lyrics. Only used when custom is true and lyric is empty.

  • modelenum

    Suno model version. 'chirp-v5-5' or 'chirp-v5' recommended for best quality.

  • negative_tagsstring

    Styles or genres to explicitly exclude from custom generation. Examples: 'heavy metal, screaming', 'autotune, electronic'

  • stylestring

    Music style description. Be specific about genre, mood, tempo, and instruments. Examples: 'upbeat pop rock, energetic drums, electric guitar', 'acoustic folk, gentle, fingerpicking', 'dark electronic, synthwave, 80s retro'

  • style_influencenumber | null

    Advanced parameter for custom mode. Controls how strongly the style prompt influences the generation.

  • titlestring

    Title of the song. Keep it concise and memorable.

  • variation_categoryenum | null

    Variation intensity for v5+ models. 'high' for maximum variation, 'normal' for balanced, 'subtle' for minimal changes. Only supported in chirp-v5 and above.

  • vocal_genderenum

    Preferred vocal gender. 'f' for female, 'm' for male, empty string for AI to decide. Only works with v4.5+ models.

  • weirdnessnumber | null

    Advanced parameter for custom mode. Controls how unusual/experimental the generation is.

suno_generate_inspo

Генерирует совершенно новую музыку на основе 1-4 референсных аудио (Suno Inspo / 灵感创作). В отличие от кавера, inspo не воспроизводит исходные треки — он черпает стилистическое вдохновение из них и сочиняет новую песню, следуя вашему запросу и тегам стиля. Используйте это, когда: - У вас есть референсные треки, настроение которых вы хотите обыграть. - Вы хотите получить новую песню «в стиле» приложенного аудио. Возвращает: Идентификатор задачи и информацию о сгенерированном аудио, включая URL, название, текст и длительность.

Параметры
  • audio_urlsstring[]обязательный

    1 to 4 publicly accessible reference audio URLs used as inspiration. Suno extracts stylistic ideas from these tracks (rather than copying them) to create a brand-new song. Tip: avoid well-known catalog recordings, which may be rejected by Suno's copyright check.

  • audio_weightnumber | null

    How strongly the reference audios influence the result, 0 to 1. Higher means closer to the references' vibe.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when generation completes.

  • modelenum

    Suno model version to use for the inspired generation.

  • promptstring

    Optional lyrics or creative brief for the new song. Leave empty to let Suno write its own lyrics.

  • stylestring

    Optional music style tags. Examples: 'acoustic, folk, warm', 'lo-fi, chill, instrumental'

  • titlestring

    Optional title of the song.

suno_generate_lyrics

Генерирует текст песни по текстовому запросу. Создаёт структурированные тексты с правильными секциями (Verse, Chorus, Bridge и т.д.) на основе вашего описания. Сгенерированный текст форматирован и готов к использованию с suno_generate_custom_music. Используйте этот инструмент, когда: - Нужен текст песни, но вы не хотите писать его самостоятельно - Вы хотите AI-сгенерированный текст для конкретной темы или настроения - Нужен правильно структурированный текст с маркерами секций Результат содержит маркеры секций, такие как [Verse], [Chorus], [Bridge], которые понимает генерация музыки Suno. Возвращает: Сгенерированный текст с названием, статусом и форматированным текстом с маркерами секций.

Параметры
  • modelenum

    Model version for lyrics generation. 'default' works well for most lyrics. 'remi-v1' offers an alternative style.

  • promptstringобязательный

    Description of the lyrics you want. Include theme, mood, genre, and any specific elements. Examples: 'A romantic ballad about lost love and rainy nights', 'An upbeat pop song about summer vacation', 'A motivational hip-hop track about overcoming obstacles'

suno_generate_music

Генерирует музыку с помощью ИИ из текстового запроса в режиме Inspiration от Suno. Это самый простой способ создать музыку — просто опишите, что вы хотите, и Suno автоматически сгенерирует подходящие текст, мелодию, стиль и аранжировку. Используйте это когда: - Вы хотите быстро сгенерировать музыку с минимальным вводом - У вас нет конкретного текста - Вы хотите, чтобы Suno проявил креативность в аранжировке Для полного контроля над текстом и стилем используйте вместо этого suno_generate_custom_music. Возвращает: Task ID и информацию о сгенерированном аудио, включая URL, название, текст и длительность.

Параметры
  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.

  • instrumentalboolean

    If true, generate instrumental music without vocals. Default is false (with vocals).

  • modelenum

    Suno model version. 'chirp-v5-5' is the latest and recommended for best quality with 8-minute max duration. 'chirp-v4-5' is a reliable choice for most use cases. Older models (v3, v3-5, v4) have shorter duration limits.

  • promptstringобязательный

    Description of the music to generate. Be descriptive about genre, mood, instruments, and theme. Examples: 'A happy birthday song with acoustic guitar', 'Epic orchestral battle music with dramatic choir', 'Chill lo-fi hip hop beat for studying'

  • variation_categoryenum | null

    Variation intensity for v5+ models. 'high' for maximum variation, 'normal' for balanced, 'subtle' for minimal changes. Only supported in chirp-v5 and above.

suno_generate_with_custom_model

Generate a song using a ready custom music model. The initial response only accepts the async task. Poll it until success or failure; this operation never falls back to another model.

Параметры
  • idstringобязательный

    Ready custom music model ID to generate with.

  • lyricstringобязательный

    Lyrics for the generated song.

  • stylestringобязательный

    Music style for the generated song.

  • titlestringобязательный

    Title for the generated song.

suno_generate_with_persona

Генерирует музыку с использованием сохранённой персоны исполнителя для единого стиля вокала. Так вы сохраняете единый голос/стиль пения в нескольких песнях, используя ранее сохранённую персону. Используйте это, когда: - Вы хотите несколько песен с одинаковым стилем вокала - Вы создаёте альбом или серию с единым вокалом - Вы нашли голос, который вам нравится, и хотите использовать его повторно Сначала создайте персону с помощью suno_create_persona, затем используйте её ID здесь. Возвращает: ID задачи и информацию о сгенерированном аудио с применённым голосом персоны.

Параметры
  • audio_idstringобязательный

    ID of a reference audio to base the generation on.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the audio is generated.

  • modelenum

    Model version to use.

  • persona_idstringобязательный

    ID of the persona to use. Get this from suno_create_persona tool. The persona defines the vocal style and characteristics.

  • promptstringобязательный

    Description of the music to generate. The persona's voice will be applied to this new song.

suno_generate_with_persona_vox

Генерирует музыку с использованием сохранённой персоны исполнителя, обеспечивая VOX-согласованность. Похож на suno_generate_with_persona, но использует действие artist_consistency_vox, оптимизированное для вокальной согласованности с персоной. Применяйте это, когда: - Нужно несколько песен в одном вокальном стиле с использованием режима VOX - Требуется более строгая вокальная согласованность, чем даёт suno_generate_with_persona - Вы создаёте контент с конкретным голосовым персонажем Сначала создайте персону с помощью suno_create_persona или suno_create_voice, затем используйте её ID здесь. Возвращает: Task ID и информацию о сгенерированном аудио с наложенным голосом персоны.

Параметры
  • audio_idstringобязательный

    ID of a reference audio to base the generation on.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use.

  • persona_idstringобязательный

    ID of the persona to use for the VOX generation. Get this from suno_create_persona or suno_create_voice tool.

  • promptstringобязательный

    Description of the music to generate. The persona's voice will be applied to this new song.

suno_get_custom_model

Retrieve a single custom music model by ID.

Параметры
  • idstringобязательный

    ID of the custom music model to retrieve.

suno_get_lyric_format_guide

Дает руководство по оформлению текстов песен для генерации музыки Suno. Показывает, как структурировать текст с отметками разделов для наилучшего результата. Следование этому формату помогает Suno понять структуру песни и генерировать подходящие мелодии для каждого раздела. Возвращает: Полное руководство с отметками разделов, примерами и советами.

Параметры

Без параметров.

suno_get_midi

Получает MIDI-данные, извлечённые из сгенерированной песни. Преобразует мелодическую и ритмическую информацию песни в формат MIDI, который можно использовать в цифровых звуковых рабочих станциях (DAW) для дальнейшего редактирования. Используйте это, когда: - Вы хотите отредактировать мелодию в DAW - Вам нужны данные на уровне нот из песни - Вы хотите воссоздать песню с другими инструментами Возвращает: ID задачи и информацию о MIDI-данных.

Параметры
  • audio_idstringобязательный

    The song ID to get MIDI data for.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

suno_get_mp3

Возвращает MP3-версию сгенерированной песни. Конвертирует песню в формат MP3: он компактный и поддерживается большинством устройств и платформ. Пригодится, если: - нужен сжатый и переносимый аудиоформат; - песней нужно поделиться на разных платформах; - важен размер файла, а не только качество WAV. Возвращает: идентификатор задачи и информацию об MP3-аудио.

Параметры
  • audio_idstringобязательный

    The song ID to get the MP3 format for.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

suno_get_mp4

Получает MP4-видео сгенерированной песни. Преобразует сгенерированное аудио в MP4-видеофайл с визуализацией. Полезно для публикации в социальных сетях или на видеоплатформах. Используйте это, когда: - Вы хотите получить видеоверсию сгенерированной песни - Вам нужно опубликовать песню на видеоплатформах - Вы хотите визуальное представление аудио Возвращает: ID задачи и информацию об MP4-видео.

Параметры
  • audio_idstringобязательный

    The song ID to get the MP4 video for. This is the 'id' field from a previous audio generation result.

suno_get_task

Запрашивает статус и результат задачи генерации музыки. Используйте его, чтобы проверить, завершена ли генерация, и получить итоговые URL аудио, названия, тексты и другие метаданные. Используйте в таких случаях: - Нужно проверить, завершилась ли генерация - Нужно получить URL аудио из предыдущей генерации - Нужно получить полные данные сгенерированной песни Состояния задачи: - 'pending': генерация ещё выполняется — ПРОДОЛЖАЙТЕ ОПРАШИВАТЬ - 'processing': генерация обрабатывается — ПРОДОЛЖАЙТЕ ОПРАШИВАТЬ - 'complete': генерация успешно завершена - 'failed': генерация не удалась (проверьте сообщение об ошибке) API может опускать свой верхнеуровневый статус. MCP приводит response.success=true к complete, а response.success=false к failed; ответы без поля success остаются в pending. Возвращает: Статус задачи и информацию о сгенерированном аудио: URL, название, текст и временные метаданные задачи.

Параметры
  • task_idstringобязательный

    The task ID returned from a generation request. This is the 'task_id' field from any suno_generate_*, suno_extend_*, suno_cover_*, or suno_concat_* tool response.

suno_get_tasks_batch

.success и suno_get_task не переводим. "The MCP" — можно оставить как "MCP" (не переводим). "top-level state" — статус верхнего уровня. Попробуем перевести: Запрашивает несколько задач генерации музыки одновременно. Эффективно проверяет статус нескольких задач в одном запросе. Более эффективно, чем многократный вызов suno_get_task. Используйте это, когда: - У вас есть несколько ожидающих генераций для проверки - Вы хотите получить статус нескольких песен одновременно - Вы отслеживаете пакет генераций MCP считает response.success=true как завершённое, а response.success=false как неудачное, когда API не указывает свой статус на верхнем уровне. Возвращает: Статус и аудиоинформацию для всех запрошенных задач. Но нужно проверить, что "suno_get_task" не переведено, что "response.success" не изменено. Всё верно. Можно немного улучшить стиль: "Вы хотите получить статус нескольких песен одновременно" — нормально. "Вы отслеживаете пакет генераций" — тоже. "Более эффективно, чем многократный вызов suno_get_task." — хорошо. "The MCP treats..." — перевели как "MCP считает..." — это допустимо. Итоговый перевод готов. Выводим без кавычек, заголовков, пояснений. Только перевод. Обратим внимание на форматирование: оригинал имеет отступ перед "Returns:" и перед списком. Сохраним. В оригинале после "Use this when:" идёт список с дефисами. У нас тоже так. Также в оригинале после "Returns:" есть отступ и строка. Сохраним. Вывод.Запрашивает несколько задач генерации музыки одновременно. Эффективно проверяет статус нескольких задач в одном запросе. Более эффективно, чем многократный вызов suno_get_task. Используйте это, когда: - У вас есть несколько ожидающих генераций для проверки - Вы хотите получить статус нескольких песен одновременно - Вы отслеживаете пакет генераций MCP считает response.success=true как завершённое, а response.success=false как неудачное, когда API не указывает свой статус на верхнем уровне. Возвращает: Статус и аудиоинформацию для всех запрошенных задач.

Параметры
  • task_idsstring[]обязательный

    List of task IDs to query. Maximum recommended batch size is 50 tasks.

suno_get_timing

Получает данные о тайминге и субтитрах для сгенерированной песни. Возвращает информацию о пословном тайминге, которую можно использовать для синхронизированного отображения текста, караоке или создания субтитров. Используйте это, когда: - Вам нужны синхронизированные текст/субтитры - Вы хотите создать отображение в стиле караоке - Вам нужен пословный тайминг для видеомонтажа Возвращает: Данные о тайминге с пословными временными метками.

Параметры
  • audio_idstringобязательный

    The song ID to get timing/subtitle data for.

suno_get_wav

Получает WAV-формат сгенерированной песни без потерь. Преобразует песню в высококачественный несжатый WAV-формат. WAV-файлы занимают больше места, но не теряют в качестве по сравнению с MP3. Используйте это, когда: - Нужен аудиоформат без потерь для продакшена - Требуется максимальное качество аудиовыхода - Нужен несжатый звук для дальнейшей обработки Возвращает: ID задачи и информацию об аудио WAV.

Параметры
  • audio_idstringобязательный

    The song ID to get the WAV format for.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

suno_list_actions

Перечисляет все доступные действия Suno API и соответствующие инструменты. Справочное руководство о том, что делает каждое действие и какой инструмент использовать. Помогает понять полные возможности Suno MCP. Возвращает: Категоризированный список всех действий и соответствующих им инструментов.

Параметры

Без параметров.

suno_list_custom_models

List custom music models for the current Suno application.

Параметры
  • limitinteger

    Maximum number of custom models to return.

  • offsetinteger

    Number of custom models to skip for pagination.

  • statusenum | null

    Optional status filter for custom models.

suno_list_models

List all available Suno models and their capabilities. Shows all available model versions with their limits, features, and recommended use cases. Use this to understand which model to choose for your music generation. Model comparison: - chirp-v6: Current v6 model - chirp-v6-wild: v6 Wild model - chirp-v6-mini: v6 Mini model - chirp-v5-5: Previous model name, retained for compatibility - chirp-v5: High quality, 8-minute max duration - chirp-v4-5-plus: High quality with 8-minute duration - chirp-v4-5: Recommended balance of quality and speed, 4-minute duration - chirp-v4: Good quality, 150 seconds max - chirp-v3-5/v3: Legacy models, 120 seconds max Returns: Table of all models with their version, limits, and features.

Параметры

Без параметров.

suno_list_personas

Выводит список всех сохранённых персон исполнителя для пользователя. Возвращает все персоны, ранее созданные с помощью suno_create_persona или suno_create_voice для данного пользователя. Используйте, когда: - Вы хотите увидеть все доступные голосовые персоны - Вам нужно найти ID персоны для использования в генерации музыки - Вы хотите управлять сохранёнными вокальными стилями Возвращает: Список персон с их ID, именами и описаниями.

Параметры
  • limitinteger

    Maximum number of personas to return. Default is 50.

  • offsetinteger

    Number of personas to skip for pagination. Default is 0.

  • user_idstringобязательный

    The user ID to list personas for.

suno_mashup_lyrics

Создаёт текст mashup, объединяя два набора текстов песен. Получает два разных текста песен и интеллектуально объединяет их в целостный mashup. Отлично подходит для создания уникальных лирических комбинаций. Используйте это, когда: - Вы хотите смешать тексты двух песен вместе - Вы создаёте mashup или попурри - Вы хотите получить креативные лирические комбинации из двух источников Возвращает: Объединённые тексты mashup, готовые к использованию в генерации музыки.

Параметры
  • lyrics_astringобязательный

    The first set of lyrics to combine. Can be full song lyrics with section markers.

  • lyrics_bstringобязательный

    The second set of lyrics to combine. Can be full song lyrics with section markers.

suno_mashup_music

Создаёт музыкальный мэшап, смешивая несколько песен. Сочетает элементы из нескольких сгенерированных песен в единый цельный трек-мэшап. Отличается от мэшапа текстов: этот смешивает реальный аудиосигнал. Используйте в следующих случаях: - Вы хотите музыкально смешать две или более песен - Вы создаёте мэшап в стиле диджея - Вы хотите объединить мелодии из разных песен Возвращает: Идентификатор задачи и информацию об аудио мэшапа.

Параметры
  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • instrumentalboolean

    If true, generate an instrumental mashup without vocals.

  • mashup_audio_idsstring[]обязательный

    Exactly two audio IDs to mash up together.

  • modelenum

    Model version to use.

  • promptstringобязательный

    Required creative direction for blending the tracks, such as the desired arrangement, mood, and balance between sources.

  • stylestring

    Optional target music style for the mashup.

  • titlestring

    Optional title for the mashup.

suno_optimize_style

Оптимизирует описание музыкального стиля для улучшения результатов генерации. Принимает черновое описание стиля и уточняет его до оптимизированного стилевого промпта, который Suno лучше понимает и использует для создания музыки более высокого качества. Используйте это, когда: - У вас есть расплывчатая идея стиля, и вы хотите её уточнить - Вам нужны более качественные стилевые промпты для suno_generate_custom_music - Нужны подсказки по стилевым терминам Возвращает: Оптимизированное описание стиля, готовое к использованию в генерации музыки.

Параметры
  • promptstringобязательный

    Style prompt words that need to be optimized. Examples: 'rock guitar', 'jazz smooth', 'electronic dance party'

suno_overpainting

Добавляет AI-генерированный вокал к загруженной инструментальной аудиодорожке. Берет загруженный инструментальный трек и накладывает на него AI-вокал (overpainting — «закрашивание» вокалом поверх музыки). Используйте это, когда: - У вас есть инструментальный трек, и вы хотите добавить вокал - Вы хотите добавить голос к фоновой музыке - Нужно добавить вокальную мелодию к существующей музыке Возвращает: ID задачи и аудио с добавленным вокалом.

Параметры
  • audio_idstringобязательный

    ID of the uploaded audio to add vocals to. Must be uploaded via suno_upload_audio.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use.

  • overpainting_endnumber | null

    End time in seconds for adding vocals. Must be less than total song duration.

  • overpainting_startnumber

    Start time in seconds for adding vocals. Default is 0.

suno_remaster_music

Ремастерит существующую песню для улучшения качества звука. Берёт ранее сгенерированную песню и применяет аудиоремастеринг для повышения чёткости, динамики и общего качества звука. Используйте это, когда: - нужно улучшить качество звука сгенерированной песни - песня, сгенерированная старой моделью, должна звучать лучше - требуется полированная, готовая к публикации версия Возвращает: идентификатор задачи (Task ID) и информацию о ремастерированном аудио.

Параметры
  • audio_idstringобязательный

    ID of the audio to remaster. This is the 'id' field from a previous generation.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use for remastering. Supported choices are chirp-v4-5-plus, chirp-v5, and chirp-v5-5.

  • variation_categoryenumобязательный

    Required remaster variation intensity. Use 'high' for maximum variation, 'normal' for balanced, or 'subtle' for minimal changes.

suno_replace_section

Replace a specific time range in a song with new generated content. Re-generates a portion of a song between the specified start and end times, keeping the rest of the song unchanged. Great for fixing sections you don't like. Use this when: - A specific section of a song needs improvement - You want to change lyrics in the middle of a song - You want to replace a verse or chorus with something different Returns: Task ID plus two complete songs by default, or two unmerged clips in candidates mode.

Параметры
  • audio_idstringобязательный

    ID of the audio to replace a section in.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • lyricstring | null

    New lyrics for the replaced section. Use section markers like [Verse], [Chorus].

  • modelenum

    Model version to use.

  • replace_section_endnumberобязательный

    End time in seconds of the section to replace.

  • replace_section_result_modeenum

    Result shape: full_song returns two complete songs, one from each replacement candidate; candidates returns the two unmerged replacement clips.

  • replace_section_startnumberобязательный

    Start time in seconds of the section to replace.

  • stylestring

    Music style for the replaced section.

suno_samples_music

Добавляет AI-сгенерированные сэмплы в загруженное аудио. Берёт ваше загруженное аудио и добавляет AI-сгенерированные музыкальные сэмплы в указанном временном диапазоне. Применяйте это, когда: - Хотите добавить сэмплы-петли или мотивы в существующую музыку - Нужно улучшить трек дополнительными музыкальными элементами - Хотите добавить AI-сгенерированные сэмплы в определённый раздел Возвращает: Идентификатор задачи и аудио с добавленными сэмплами.

Параметры
  • audio_idstringобязательный

    ID of the uploaded audio to add samples to. Must be uploaded via suno_upload_audio.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use.

  • samples_endnumber | null

    End time in seconds for adding samples. Must be less than total song duration.

  • samples_startnumber

    Start time in seconds for adding samples. Default is 0.

suno_stems_music

Разделяет песню на отдельные стемы (вокал и инструменты). Разделяет аудио на отдельные дорожки для вокала и инструментов, что полезно для ремиксов, караоке или изоляции определённых частей. Используйте этот инструмент, когда: - нужно отделить вокал от инструментов - требуются отдельные стемы для микширования - нужно создать караоке-версию Возвращает: Идентификатор задачи и результаты разделения на стемы с URL-адресами отдельных дорожек.

Параметры
  • audio_idstringобязательный

    ID of the audio to separate into stems.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

suno_underpainting

Добавляет AI-сгенерированный аккомпанемент/инструментальный фон к загруженному аудио. Принимает ваш загруженный вокальный трек и добавляет AI-сгенерированный инструментальный аккомпанемент под ним (underpainting = добавление музыки под вокал). Используйте это, когда: - У вас есть запись вокала, и вы хотите добавить за ней музыку - Вы хотите дать акапельному треку полноценную музыкальную аранжировку - Вам нужно добавить инструментальное сопровождение к существующему вокалу Возвращает: Идентификатор задачи и аудио с добавленным аккомпанементом.

Параметры
  • audio_idstringобязательный

    ID of the uploaded audio to add accompaniment to. Must be uploaded via suno_upload_audio.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use.

  • underpainting_endnumber | null

    End time in seconds for adding accompaniment. Must be less than total song duration.

  • underpainting_startnumber

    Start time in seconds for adding accompaniment. Default is 0.

suno_upload_audio

Upload external audio for use in subsequent operations. Use standard mode for normal uploads. Use enhanced mode only when standard upload cannot process authorized audio; it returns a task_id for suno_get_task. Enhanced audio IDs support Cover, Samples, and Mashup.

Параметры
  • audio_urlstringобязательный

    Public URL of the audio file. Enhanced mode requires HTTPS and audio you own or are authorized to use.

  • callback_urlstring | null

    Optional HTTPS webhook URL for the enhanced upload result.

  • modeenum

    Upload mode. standard preserves normal upload behavior; enhanced handles some authorized audio that standard mode cannot process, costs 1.87 Credits on success, and runs asynchronously.

  • namestring | null

    Audio name, required for enhanced mode and limited to 100 characters.

suno_upload_cover

Создаёт AI-кавер из загруженного аудио (вашей собственной музыки). Аналогичен suno_cover_music, но работает с аудио, загруженным через suno_upload_audio. Переаранжирует вашу музыку в другом стиле. Используйте это, когда: - Вы загрузили свою музыку и хотите кавер в другом стиле - Вы хотите услышать, как ваша песня переосмысливается AI Возвращает: Идентификатор задачи и информацию о кавер-аудио.

Параметры
  • audio_idstringобязательный

    ID of the uploaded audio to create a cover of. Must be an audio uploaded via suno_upload_audio.

  • audio_weightnumber | null

    Advanced parameter for cover operations. Controls how much the original audio influences the cover generation.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • modelenum

    Model version to use.

  • stylestring

    Target music style for the cover.

suno_upload_extend

Расширяет загруженное аудио (вашу собственную музыку) новым AI-сгенерированным контентом. Похоже на suno_extend_music, но работает с аудио, которое вы загрузили через suno_upload_audio. Позволяет добавлять новые разделы в вашу собственную музыку. Используйте это, когда: - Вы загрузили свою музыку и хотите расширить её - Вы хотите добавить AI-сгенерированные разделы к вашим существующим записям Возвращает: ID задачи и информацию о расширенном аудио.

Параметры
  • audio_idstringобязательный

    ID of the uploaded audio to extend. Must be an audio uploaded via suno_upload_audio.

  • callback_urlstring | null

    Webhook callback URL for asynchronous notifications.

  • continue_atnumberобязательный

    Timestamp in seconds where to start the extension.

  • lyricstringобязательный

    Lyrics for the extension section.

  • modelenum

    Model version to use.

  • stylestring

    Music style for the extension.

Похожие MCP-сервера

skyworkai/mureka-mcp

skyworkai/mureka-mcp

Mureka MCP сервер даёт ИИ-агентам (Claude Desktop, OpenAI Agents) возможность генерировать тексты, песни и фоновую музыку (инструментал). Полезен музыкантам и разработчикам для автоматизации создания аудиоконтента.

Python113
gaudiolab-jp/gaudio-developers-mcp

gaudiolab-jp/gaudio-developers-mcp

MCP-сервер Gaudio AI API. Извлекайте вокал, инструменты, диалоги, музыку и эффекты из аудио/видео, синхронизируйте текст с таймкодами через естественный язык в AI-инструментах музыкантам, редактора...

TypeScript1
jau123/MeiGen-AI-Design-MCP

jau123/MeiGen-AI-Design-MCP

MCP-сервер для генерации изображений и видео через ИИ. Работает в Claude Code, Cursor и других AI-инструментах, поддерживает 9 моделей и 1446 промптов. Параллельная генерация, управление стилями и ...

TypeScript1747
AetherWave-Studio/aetherwave-mcp

AetherWave-Studio/aetherwave-mcp

MCP сервер AetherWave Studio объединяет 16+ инструментов генерации контента: изображения, видео, музыка, мастеринг. Один API-ключ и пул кредитов дают доступ к Suno, Grok, Midjourney, Topaz. Интегри...

JavaScript6
raveenb/fal-mcp-server

raveenb/fal-mcp-server

MCP сервер для генерации изображений, видео, музыки и аудио через Fal.ai. Интегрируется с Claude Desktop и любыми MCP-клиентами, предлагая 18 инструментов: от текстовых промптов до ретуши и анимации. Полезен разработчикам и креаторам для быстрого создания контента без переключения между сервисами.

Python53
elestirelbilinc-sketch/vap-showcase

elestirelbilinc-sketch/vap-showcase

MCP-сервер VAP Media добавляет AI-агентам генерацию изображений Flux, видео Veo и музыки Suno с детерминированным ценообразованием. Управляй затратами, используй готовые инструменты в Claude Deskto...

Python1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин