GS

gabrielbief/suno-mcp

浏览器自动化

本页由 AI 翻译,技术细节请以原文为准。 查看原文

1 stars 9 forks 质量 65 趋势 5MIT

This is a for basic Suno AI music generation. No fake Studio automation - just reliable tools that actually work.

概览

This is a for basic Suno AI music generation. No fake Studio automation - just reliable tools that actually work. Complete MCP integration with Suno AI for music generation, login, and download functionality. No Suno Studio automation (requires Premier subscription + complex DOM reverse engineering). 🎵 - Login to Suno AI accounts (free tier) - Generate music with text prompts - Support for styles, lyrics, and custom parameters - Download generated tracks (MP3 format) - Session management and status monitoring 🔧 - Claude Desktop stdio interface ✅ - FastAPI HTTP API for web integration ✅ - FastMCP 2.12 compliance ✅ - Comprehensive error handling ✅ - Production-ready logging ✅ - - "Generate a rock song about adventure" - - Generate multiple tracks programmatically - - Combine with your Reaper MCP for full production pipeline - - No expensive subscriptions required 1. "Create a rock song about adventure with lyrics about mountains and dragons" 2.

README

以下为原文 README 节选,完整内容请查看原文。

Suno-MCP: Basic AI Music Generation

✅ REALISTIC SCOPE: WORKING SUNO AI INTEGRATION

HONEST ASSESSMENT: This is a solid, working MCP server for basic Suno AI music generation. No fake Studio automation - just reliable tools that actually work.

Overview

WHAT WORKS: Complete MCP integration with Suno AI for music generation, login, and download functionality.

WHAT’S NOT INCLUDED: No Suno Studio automation (requires Premier subscription + complex DOM reverse engineering).

Features

✅ Working Features

🎵 Suno AI Music Generation

  • Login to Suno AI accounts (free tier)
  • Generate music with text prompts
  • Support for styles, lyrics, and custom parameters
  • Download generated tracks (MP3 format)
  • Session management and status monitoring

🔧 MCP Integration

  • Claude Desktop stdio interface ✅
  • FastAPI HTTP API for web integration ✅
  • FastMCP 2.12 compliance ✅
  • Comprehensive error handling ✅
  • Production-ready logging ✅

🎵 Perfect For:

  • Claude Desktop integration - “Generate a rock song about adventure”
  • Batch music creation - Generate multiple tracks programmatically
  • Creative workflows - Combine with your Reaper MCP for full production pipeline
  • Free tier usage - No expensive subscriptions required

🎵 Demo Workflow with Claude Desktop

Perfect integration with your Reaper MCP server:

  1. Claude: “Create a rock song about adventure with lyrics about mountains and dragons”
  2. Suno-MCP: Generates AI music track with matching lyrics
  3. Download: Saves MP3 to your local machine
  4. Reaper MCP: Imports track and applies professional mixing/mastering
  5. Result: Complete song production pipeline

Example prompts that work:

  • “Generate an upbeat pop song about summer love”
  • “Create a cinematic orchestral piece for a fantasy movie”
  • “Make a chill electronic track with atmospheric pads”
  • “Generate hip-hop beats with motivational lyrics”

Installation

Prerequisites

  • Python 3.10+ installed
  • Claude Desktop with MCP support
  • Free Suno AI account (no subscription required)
  • Optional: Reaper DAW with your Reaper MCP server for full production pipeline

Setup Steps

  1. Install Dependencies
cd D:\Dev\repos\suno-mcp
pip install -r requirements.txt
  1. Install Playwright Browsers
playwright install chromium
  1. Test Installation
python -m suno_mcp.server
  1. Configure Claude Desktop Add to claude_desktop_config.json:

Windows:

{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "D:\\Dev\\repos\\suno-mcp\\src"
      }
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "/path/to/suno-mcp/src"
      }
    }
  }
}
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "suno-mcp": { "command": "python", "args": ["-m", "suno_mcp.server"], "env": { "PYTHONPATH": "D:\\Dev\\repos\\suno-mcp\\src" } } } }