Suno MCP Integration Guide

MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through standardized interfaces. With the Suno MCP Server provided by AceData Cloud, you can directly generate music, lyrics, and manage audio projects in AI clients like Claude Desktop, VS Code, Cursor, etc.

Feature Overview

The Suno MCP Server provides the following core functionalities:

  • Music Generation — Generate AI music through text prompts
  • Custom Creation — Full control over lyrics, titles, and music styles
  • Song Continuation — Extend existing songs from any point in time
  • Cover/Remix — Create cover versions in different styles
  • Lyric Generation — Generate structured lyrics based on descriptions
  • Vocal Persona — Save and reuse vocal styles
  • Media Conversion — Obtain MP4, WAV, MIDI, vocal separation, etc.
  • Style Optimization — Optimize music style tags
  • Task Query — Monitor generation progress and obtain results

Prerequisites

Before using, you need to obtain an AceData Cloud API Token:

  1. Register or log in to the AceData Cloud platform
  2. Go to the Suno Audios API page
  3. Click "Acquire" to get the API Token (first-time applicants receive free credits)

Installation Configuration

Method 1: pip Installation (Recommended)

pip install mcp-suno

Method 2: Source Installation

git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
pip install -e .

Once installed, you can use the mcp-suno command to start the service.

Using in Claude Desktop

Edit the Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

If using uvx (no need to install the package in advance):

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

After saving the configuration, restart Claude Desktop to use Suno-related tools in conversations.

Using in VS Code / Cursor

Create a .vscode/mcp.json in the project root directory:

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

Or use uvx:

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

Available Tools List

Tool Name Description
suno_generate_music Generate music through text prompts
suno_generate_custom_music Generate music with custom lyrics and style
suno_extend_music Continue a song from a specified time point
suno_cover_music Create a cover version
suno_concat_music Concatenate song segments
suno_generate_with_persona Generate music using a specified vocal persona
suno_remaster_music Remaster the audio
suno_stems_music Separate tracks (vocals/accompaniment)
suno_replace_section Replace specified sections in a song
suno_upload_extend Upload audio and continue writing
suno_upload_cover Upload audio and cover
suno_mashup_music Mash up multiple songs
suno_generate_lyrics Generate lyrics based on descriptions
suno_create_persona Create a vocal persona
suno_get_mp4 Get song MP4 video
suno_get_timing Get lyrics timing
suno_extract_vocals Extract vocals
suno_get_wav Get high-quality WAV
suno_get_midi Get MIDI file
suno_optimize_style Optimize music style tags
suno_mashup_lyrics Mash up lyrics
suno_upload_audio Upload custom audio
suno_get_task Query the status of a single task
suno_get_tasks_batch Batch query task statuses

Usage Examples

After configuration, you can directly call these functions in AI clients using natural language, for example:

  • "Help me generate a pop song about summer"
  • "Cover this song in jazz style"
  • "Continue this song from the 30-second mark"
  • "Generate a Chinese lyric with the theme of travel"
  • "Separate the vocals from this song"
  • "Help me convert this song to MIDI format"

More Information