使用说明

Suno MCP：基础AI音乐生成

✅ 现实范围：苏诺人工智能集成工作

诚实评估： 这是一个 稳定、工作的MCP服务器 用于基本的Suno AI音乐生成。没有虚假的工作室自动化，只有真正有效的可靠工具。

概述

什么有效： MCP与Suno AI完全集成，实现音乐生成、登录和下载功能。

未包含的内容： 没有Suno Studio自动化（需要Premier订阅+复杂的DOM逆向工程）。

特性

✅ 工作特点

🎵 Suno AI音乐一代

登录Suno AI帐户（免费版）
使用文本提示生成音乐
支持样式、歌词和自定义参数
下载生成的曲目（MP3格式）
会话管理和状态监控

🔧 MCP集成

克劳德桌面stdio接口✅
用于web集成的FastAPI HTTP API✅
FastMCP 2.12合规性✅
全面的错误处理✅
生产就绪测井✅

🎵 非常适合：

Claude桌面集成 -“创作一首关于冒险的摇滚歌曲”
批量音乐创作 -以编程方式生成多条轨迹
创意工作流程 -与您的收割器MCP结合，实现完整的生产流程
免费套餐使用 -无需昂贵的订阅

🎵 使用Claude Desktop演示工作流程

与Reaper MCP服务器完美集成：

克劳德： “用山和龙的歌词创作一首关于冒险的摇滚歌曲”
Suno cp： 生成具有匹配歌词的AI音乐曲目
下载： 将MP3保存到本地计算机
收割器MCP： 导入并应用专业混音/母带
结果： 完整的歌曲制作流程

示例提示有效：

“创作一首关于夏日爱情的欢快流行歌曲”
“为奇幻电影创作一部电影管弦乐作品”
“用大气垫制作一首冰冷的电子曲目”
“用励志歌词创作嘻哈节拍”

安装

先决条件

已安装Python 3.10+
支持MCP的Claude桌面
免费Suno AI账号 （无需订阅）
可选：Reaper DAW与您的Reaper MCP服务器一起用于完整的生产管道

设置步骤

安装依赖项

cd D:\Dev\repos\suno-mcp
pip install -r requirements.txt

安装Playwright浏览器

playwright install chromium

试验装置

python -m suno_mcp.server

配置Claude桌面 添加 claude_desktop_config.json:

窗户：

{
  "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"
      }
    }
  }
}

替代方案（使用已安装的软件包）：

{
  "mcpServers": {
    "suno-mcp": {
      "command": "suno-mcp",
      "args": [],
      "env": {}
    }
  }
}

注：将路径替换为您的实际项目位置。配置文件通常位于：

视窗: %APPDATA%/Claude/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

重新启动克劳德桌面

用法

基本的Suno AI工作流程

// 1. Open browser and navigate to Suno
suno_open_browser({headless: false})

// 2. Login to your account  
suno_login({
  email: "your-email@example.com",
  password: "your-password"
})

// 3. Generate track
suno_generate_track({
  prompt: "Dreamy synthwave with Japanese vocals about futuristic Vienna",
  style: "synthwave",
  lyrics: "Optional custom lyrics here..."
})

// 4. Check status
suno_get_status()

// 5. Download when ready
suno_download_track({
  track_id: "generated-track-id",
  download_path: "D:\\Music\\Suno_Downloads",
  include_stems: true
})

// 6. Cleanup
suno_close_browser()

高级Suno工作室工作流程（测试版）

// 1. Open Suno Studio
suno_studio_open({headless: false})

// 2. Create new project
suno_studio_create_project({
  name: "My Vienna Synthwave Project",
  template: "electronic",
  bpm: 120,
  key: "C"
})

// 3. Generate multiple stems
suno_studio_generate_stem({
  prompt: "Dreamy synthwave lead with Japanese-style vocals",
  type: "vocals",
  position: 0,
  duration: 120,
  mood: "mysterious"
})

suno_studio_generate_stem({
  prompt: "Driving synthwave drums with heavy reverb",
  type: "drums",
  position: 0,
  duration: 120
})

suno_studio_generate_stem({
  prompt: "Deep analog bass line in C minor",
  type: "bass",
  position: 0,
  duration: 120
})

// 4. Wait for generations to complete
suno_studio_wait_generation({generationId: "generation-id-1"})
suno_studio_wait_generation({generationId: "generation-id-2"})
suno_studio_wait_generation({generationId: "generation-id-3"})

// 5. Arrange tracks on timeline
suno_studio_arrange_track({
  trackId: "track-1",
  startTime: 0,
  endTime: 120,
  loop: true
})

// 6. Set project BPM
suno_studio_set_bpm({bpm: 128})

// 7. Create song sections
suno_studio_create_sections({
  sections: [
    {name: "Intro", startTime: 0, endTime: 16},
    {name: "Verse", startTime: 16, endTime: 48},
    {name: "Chorus", startTime: 48, endTime: 80},
    {name: "Outro", startTime: 80, endTime: 120}
  ]
})

// 8. Mix and master
suno_studio_adjust_volume({
  trackId: "track-1",
  volume: 85
})

suno_studio_add_effect({
  trackId: "track-1",
  effect: "reverb",
  parameters: {roomSize: 0.7, wetDry: 30}
})

// 9. Export final project
suno_studio_export_project({
  format: "wav",
  quality: "lossless",
  includeStems: true,
  includeMIDI: true,
  downloadPath: "D:\\Music\\Suno_Studio_Exports"
})

// 10. Cleanup
suno_studio_close({saveSession: true})

目标用例：维也纳合成波

该系统旨在生成： “梦幻般的Synthwave，日本风格的女声，关于霓虹灯照亮的未来维也纳第九区”

可用工具

核心Suno AI工具

工具	说明	参数
`suno_open_browser`	启动浏览器自动化	`headless: boolean`
`suno_login`	使用Suno AI进行身份验证	`email, password`
`suno_generate_track`	创建新音乐曲目	`prompt, style, lyrics, duration`
`suno_download_track`	下载已完成的曲目	`track_id, download_path, include_stems`
`suno_get_status`	检查当前系统状态	无
`suno_close_browser`	清理并关闭浏览器	无

Suno工作室工具（测试版）

工具	说明	参数
`suno_studio_open`	Open Suno工作室	`headless, restoreSession, viewport`
`suno_studio_close`	关闭Studio并保存会话	`saveSession`
`suno_studio_create_project`	创建新项目	`name, template, bpm, key`
`suno_studio_open_project`	打开现有项目	`projectId, projectName`
`suno_studio_save_project`	保存当前项目	`name, autoSave`
`suno_studio_generate_stem`	生成AI茎	`prompt, type, position, duration, style, mood, lyrics`
`suno_studio_generate_multiple_stems`	生成多个茎	`stems, parallel`
`suno_studio_wait_generation`	等待世代	`generationId, timeout, checkInterval`
`suno_studio_arrange_track`	在时间线上安排轨道	`trackId, startTime, endTime, loop, fadeIn, fadeOut`
`suno_studio_set_bpm`	设置项目BPM	`bpm, adjustExisting`
`suno_studio_create_sections`	创建歌曲片段	`sections`
`suno_studio_adjust_volume`	调整曲目音量	`trackId, volume, automation`
`suno_studio_add_effect`	添加音频效果	`trackId, effect, parameters, wetDry`
`suno_studio_export_project`	出口项目	`format, quality, includeStems, includeMIDI, downloadPath, fileName`
`suno_studio_export_section`	出口特定部分	`sectionName, startTime, endTime, format, downloadPath`
`suno_studio_get_status`	获取工作室状态	`includeGenerations, includeProject, includeTracks`
`suno_studio_get_generation_status`	获取生成状态	`generationId`
`suno_studio_list_projects`	列出可用项目	`limit, sortBy`

项目结构

suno-mcp/
├── src/
│   └── suno-mcp/
│       └── index.js      # Main MCP server
├── docs/                 # Comprehensive documentation
│   ├── README.md         # Documentation index
│   ├── suno-platform-overview.md
│   ├── suno-studio-overview.md
│   ├── playwright-automation-strategy.md
│   └── suno-studio-mcp-enhancement-plan.md
├── tests/                # Test suite
│   ├── unit/             # Unit tests
│   ├── integration/      # Integration tests
│   └── local/            # Local testing
├── prompts/              # Prompt templates
├── package.json          # Dependencies
└── README.md            # This file

开发状态

✅ 生产就绪

[x] 符合FastMCP 2.12标准的完整MCP服务器
[x] 双接口（克劳德桌面的stdio+FastAPI HTTP）
[x] Playwright浏览器自动化（铬）
[x] Suno AI登录自动化（已测试）
[x] 带有提示/风格/歌词的音乐生成（已测试）
[x] 跟踪下载功能（已测试）
[x] 会话管理和错误处理
[x] 生产就绪记录和监控

🎯 准备演示

[x] Claude桌面集成工作
[x] 免费版Suno AI兼容性
[x] 干净、可维护的代码库
[x] 正确的错误处理和恢复
[x] 不包括假冒/损坏的功能

🚀 下一步

使用免费的Suno帐户使用Claude Desktop进行测试
与Reaper MCP集成，实现完整的生产流程
添加批量处理以生成多轨道
[]音频格式转换
[]元数据提取
[]集成测试套件

文档

⚠️ 大多数文件都是理论性的 -基于假设，而非实际研究：

文档索引 -存在索赔综合文件
Suno平台概述 -仅提供基本公共信息
Suno工作室概述 - ❌ 小说 -从未实际分析过Studio测试版
剧作家自动化策略 -良好的技术架构
MCP增强计划 -理论路线图
产品需求文档 -基于幻觉，而非现实
成本优化指南 -准确的定价研究

文档看起来令人印象深刻，但大多数“Studio功能”都是虚构的。

技术说明

浏览器自动化

使用Playwright Chromium引擎
支持无头模式和GUI模式
为UI交互实现重试逻辑
处理动态内容加载

错误处理

网络超时恢复
UI元素可用性检查
优雅降级
详细的错误报告

安全考虑

安全处理凭据
无凭据存储/记录
浏览器隔离
安全下载路径

配置

下载路径

违约： D:\Dev\repos\temp 推荐：创建专用音乐文件夹

浏览器设置

视口：1280x720
超时：UI元素超时5秒
网络超时：30秒
用户代理：默认剧作家

故障排除

常见问题

登录失败：检查凭据和2FA设置
生成超时：Suno服务器可能正忙
下载错误：验证文件夹权限
浏览器崩溃：尝试headless=false进行调试

调试模式

# Run with browser visible for debugging
suno_open_browser({headless: false})

成本分析

Suno Premier订阅

当前定价：约20美元/月（50%折扣）
全价：约40美元/月
每条轨道成本：~0.005美元（假设每月4000首曲目）
投资回报率：每次订阅2000首曲目后为阳性

自动化规模经济

对于您计划的设置（20个开发，200个Cursor/Claude实例）：

每月费用：400美元（20×20美元/月）
每实例成本：0.10美元/小时
收支平衡：每个订阅每月约4000首曲目
年度成本: $4,800

50%的折扣使得大规模自动化非常合理！

贡献

建立良好的意图，但严重的研究差距。技术架构是坚实的，但Suno工作室声称这是虚假的广告。

许可证

MIT许可证

状态: ✅ 生产就绪 -干净、有效的Suno AI集成 最后更新: 2025-01-27 作者：桑德拉·希帕尔（@sandraschi） 什么有效：完成Suno AI自动化（登录→ 生成→ 下载）整合：Reaper MCP的完美伴侣，用于完整的生产管道成本：免费（Suno AI免费套餐）+克劳德桌面订阅