Suno MCP Integration Guide

suno MCP 服务器集成

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/MCPSuno.git
cd MCPSuno
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

• GitHub Repository: AceDataCloud/MCPSuno
• PyPI Package: mcp-suno
• API Documentation: Suno Music Generation API