
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:
- Claude: “Create a rock song about adventure with lyrics about mountains and dragons”
- Suno-MCP: Generates AI music track with matching lyrics
- Download: Saves MP3 to your local machine
- Reaper MCP: Imports track and applies professional mixing/mastering
- 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
- Install Dependencies
cd D:\Dev\repos\suno-mcp
pip install -r requirements.txt
- Install Playwright Browsers
playwright install chromium
- Test Installation
python -m suno_mcp.server
- 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"
}
}
}
}
安装
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"
}
}
}
}