GS

gabrielbief/suno-mcp

Browser automation

이 페이지는 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 MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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