> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno MCP Integration Guide

> suno MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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 XHuoAPI, 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 XHuoAPI API Token:

1. Register or log in to the [XHuoAPI platform](https://api.xhuoapi.ai)
2. Go to the [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios) page
3. Click "Acquire" to get the API Token (first-time applicants receive free credits)

## Installation Configuration

### Method 1: pip Installation (Recommended)

```bash theme={null}
pip install mcp-suno
```

### Method 2: Source Installation

```bash theme={null}
git clone https://github.com/XHuoAPI/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:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "your API Token"
      }
    }
  }
}
```

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

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "your API Token"
      }
    }
  }
}
```

Or use `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* PyPI Package: [mcp-suno](https://pypi.org/project/mcp-suno/)
* API Documentation: [Suno Music Generation API](https://api.xhuoapi.ai/documents/suno)