Suno MCP

一个用于通过 Suno 生成音乐的 MCP (Model Context Protocol) 服务器。

功能特性

• 生成歌曲：支持自定义歌词和风格标签

• 根据描述生成：让 Suno AI 编写歌词

• 等待完成：获取带有 Markdown 嵌入的音频 URL

• 下载 MP3：下载到本地文件夹

• 自动刷新令牌：令牌过期时自动刷新

Related MCP server: Suno-MCP

要求

• Node.js 18+

• BrowserOS（或任何带有 --remote-debugging-port 的 Chromium），运行在 http://localhost:9100 且已登录 Suno。可通过 CDP_URL 覆盖。

• Suno 账户（免费或付费均可）

安装

npm install

与 Claude Code 一起使用

添加到你的 .mcp.json 中：

{
  "suno": {
    "command": "node",
    "args": ["/path/to/suno-mcp/src/index.js"]
  }
}

工具

工作原理

身份验证

Suno 使用 Clerk 进行身份验证，并使用短效 JWT 令牌。客户端通过 CDP 在活动的 Suno 标签页中调用 window.Clerk.session.getToken() —— Clerk 会在后台处理刷新，因此无需重新加载页面。令牌会在其 exp 声明过期前 5 分钟进行缓存。

歌曲生成

由于 hCaptcha 的存在，直接调用 API 会失败。客户端不是抓取表单选择器，而是驱动 Suno 自己的 React 应用：

1. 通过 CDP 连接到 Suno 标签页；如有必要，导航至 /create。

2. 从“创建”按钮遍历 React fiber 树，找到将 onCreateClick / lyrics / styles / mode 作为 props 暴露的组件 —— 即语义化的生成处理程序。

3. 使用与 React 兼容的原生 setter 填充歌词和风格文本区域，从而更新内部状态。

4. 等待 fiber 的 props 反映出新值（即 React 已重新渲染）。

5. 通过 CDP Input.dispatchMouseEvent 在按钮坐标处分发受信任的鼠标点击事件。hCaptcha 将 CDP 合成的事件视为真实的用户手势（直接从 JS 调用 onCreateClick() 则不行 —— 验证码会拒绝）。

6. 通过 CDP Network 事件捕获 /api/generate/v2 的响应，以返回新的片段 ID。如果错过了网络事件，则回退到轮询 /api/project/default。

这种方法对于 UI 改版具有鲁棒性：它依赖于语义化的 React props (onCreateClick, lyrics, styles) 和 aria-label="Create song" 按钮 —— 这两者都是核心功能且不太可能改变 —— 而不是依赖类名、textContent 匹配或 DOM 布局。

示例

// Generate a song
const result = await suno_generate_song({
  lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test",
  style: "indie folk, acoustic, male vocals"
});

// Wait for it to complete
const songs = await suno_wait_for_songs({
  ids: result.songIds
});

// Download it
await suno_download_song({
  songId: songs[0].id,
  folder: "./downloads"
});

已知限制

• 标题字段无法可靠工作（Suno UI 限制 —— 目前未通过新的生成路径连接）。

• generate_from_description（简单模式）如果找不到 UI 模式切换开关，目前会回退到自定义模式；为了获得确定性的行为，请通过 generate_song 传递歌词和风格。

• 需要 BrowserOS 且保持活跃、可见的 Suno 会话。创建按钮在屏幕上必须具有非零尺寸，以便受信任的点击能够生效。

• 令牌每约 1 小时过期一次（通过 Clerk 自动刷新）。

许可证

MIT