MCP-Suno

MCP-Suno

MCP (Model Context Protocol) server for Suno music generation API.

Features

• Generate Lyrics: Create lyrics based on a description or theme
• Generate Music: Create custom songs with lyrics, style tags, and model selection
• Automatic Polling: Built-in polling mechanism for async task completion

Installation

1. Clone or download this repository
2. Install dependencies:

npm install

1. Set up your API key by creating a .env file:

cp .env.example .env

Edit .env and add your Suno API key:

SUNO_API_KEY=your_actual_api_key_here

Building

npm run build

Running

npm start

Or for development:

npm run dev

MCP Configuration

Add this server to your MCP client configuration:

{
  "mcpServers": {
    "suno": {
      "type": "stdio",
      "command": "node",
      "args": ["E:\\xxx\\xxx\\xxx\\suno-mcp-1313api\\dist\\index.js"],
      "env": {
        "SUNO_API_KEY": "your_api_key_here"
      }
      "timeout": 600,
    }
  }
}

Available Tools

generate_lyrics

Generate lyrics based on a description or theme.

Parameters:

• prompt (required): Description or theme for lyrics (e.g., "dance", "love song", "epic battle")

Returns:

• task_id: The task ID for tracking
• title: Generated song title
• lyrics: Full lyrics text
• status: Task completion status

Example: ``json { "prompt": "a romantic sunset song about two lovers meeting" } ``

generate_music

Generate music with custom lyrics.

Parameters:

• prompt (required): The lyrics for the song in Suno format (with [Verse], [Chorus], [Bridge] tags)
• title (required): Title of the song
• tags (optional): Music style tags (e.g., "pop, upbeat, female vocals", "rock, energetic")
• mv (optional): Model version (default: "chirp-v4")

Returns:

• task_id: The task ID for tracking
• songs: Array of generated songs with:
• id: Song ID
• title: Song title
• tags: Style tags
• audio_url: MP3 audio file URL
• video_url: MP4 video file URL
• image_url: Cover image URL
• image_large_url: Large cover image URL
• duration: Song duration in seconds
• model_name: Model used
• status: Generation status
• lyrics: Full lyrics text

Example: ``json { "prompt": "[Verse]\nWalking down the street\nFeeling the beat\nMusic in my soul\nTaking control\n\n[Chorus]\nThis is my song\nSinging all night long\nFeel the rhythm\nMoving along", "title": "My Song", "tags": "pop, upbeat, electronic", "mv": "chirp-v4" } ``

API Endpoints

This MCP server uses the following API endpoints:

• Submit Lyrics: POST https://1313api.top/suno/submit/lyrics
• Submit Music: POST https://1313api.top/suno/submit/music
• Fetch Task: GET https://1313api.top/suno/fetch/{task_id}

Polling Behavior

The server automatically polls for task completion with the following settings:

• Max Attempts: 60
• Polling Interval: 3 seconds
• Total Timeout: ~3 minutes

Tasks are polled until they reach SUCCESS or FAILED status, or timeout is reached.

Error Handling

The server returns error messages in the following format:

{
  "error": "Error message description"
}

Common errors:

• SUNO_API_KEY environment variable is not set: API key not configured
• Failed to submit lyrics generation: API request failed
• Task failed: Generation failed on the server
• Task timeout: Generation took too long

License

MIT