Suno MCP 对接指南

MCP（Model Context Protocol）是由 Anthropic 推出的模型上下文协议，允许 AI 模型（如 Claude、GPT 等）通过标准化接口调用外部工具。通过 AceData Cloud 提供的 Suno MCP Server，你可以在 Claude Desktop、VS Code、Cursor 等 AI 客户端中直接生成音乐、歌词，并管理音频项目。

功能概览

Suno MCP Server 提供以下核心功能：

音乐生成 — 通过文本提示词生成 AI 音乐
自定义创作 — 完全控制歌词、标题和音乐风格
歌曲续写 — 从任意时间点继续延长已有歌曲
翻唱/混音 — 用不同风格创建翻唱版本
歌词生成 — 根据描述生成结构化歌词
人声角色 — 保存和复用声音风格
媒体转换 — 获取 MP4、WAV、MIDI、人声分离等
风格优化 — 优化音乐风格标签
任务查询 — 监控生成进度并获取结果

前置准备

使用前，你需要获取 AceData Cloud API Token：

注册或登录 AceData Cloud 平台
前往 Suno Audios API 页面
点击「Acquire」获取 API Token（首次申请赠送免费额度）

方式一：使用托管 MCP Server（推荐，零安装）

AceData Cloud 已经把 Suno MCP Server 托管在云端，无需本地安装任何依赖，直接在 AI 客户端里填写下面这个 URL 就能用：

https://suno.mcp.acedata.cloud/mcp

认证方式：在请求头中加上 Authorization: Bearer 你的API Token 即可（Claude.ai 通过 OAuth 自动完成，无需手动填 Token）。

Claude.ai（网页版，OAuth 登录，最简单）

打开 Claude.ai → 左下角 Customize → Connectors → Add More
在 URL 处填入：https://suno.mcp.acedata.cloud/mcp
完成 OAuth 授权登录（自动跳转 AceData Cloud 登录页）
回到对话界面，工具即可使用

Claude Desktop

编辑配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "suno": {
      "type": "http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer 你的API Token"
      }
    }
  }
}

保存后重启 Claude Desktop 即可生效。

Claude Code（终端命令行）

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 你的API Token"

VS Code（GitHub Copilot）

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "suno": {
      "type": "http",
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer 你的API Token"
      }
    }
  }
}

Cursor

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "suno": {
      "url": "https://suno.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer 你的API Token"
      }
    }
  }
}

其他支持 MCP 的客户端

任何支持 MCP Streamable HTTP 协议的客户端（Windsurf、Cline、ChatGPT Connectors、Gemini CLI、JetBrains AI Assistant 等）都可以通过填写以下两项接入：

URL：https://suno.mcp.acedata.cloud/mcp
Header：Authorization: Bearer 你的API Token

方式二：本地运行（pip / uvx 安装）

如果你需要离线运行、自定义代码或部署到内网，可以把 MCP Server 安装在本地通过 stdio 启动。

安装

pip 安装（推荐）：

pip install mcp-suno

或源码安装：

git clone https://github.com/AceDataCloud/SunoMCP.git
cd SunoMCP
pip install -e .

安装完成后，即可使用 mcp-suno 命令启动服务。

在 Claude Desktop 中使用（本地）

编辑 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

如果使用 uvx（无需提前安装包）：

{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

保存配置后重启 Claude Desktop 即可生效。

在 VS Code / Cursor 中使用（本地）

在项目根目录创建 .vscode/mcp.json：

{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

或者使用 uvx：

{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

可用工具列表

工具名	说明
`suno_generate_music`	通过文本提示词生成音乐
`suno_generate_custom_music`	自定义歌词和风格生成音乐
`suno_extend_music`	从指定时间点续写歌曲
`suno_cover_music`	创建翻唱版本
`suno_concat_music`	拼接歌曲片段
`suno_generate_with_persona`	使用指定人声角色生成音乐
`suno_remaster_music`	重新母带处理
`suno_stems_music`	分离音轨（人声/伴奏）
`suno_replace_section`	替换歌曲中的指定片段
`suno_upload_extend`	上传音频并续写
`suno_upload_cover`	上传音频并翻唱
`suno_mashup_music`	混搭多首歌曲
`suno_generate_lyrics`	根据描述生成歌词
`suno_create_persona`	创建人声角色
`suno_get_mp4`	获取歌曲 MP4 视频
`suno_get_timing`	获取歌词时间轴
`suno_extract_vocals`	提取人声
`suno_get_wav`	获取高质量 WAV
`suno_get_midi`	获取 MIDI 文件
`suno_optimize_style`	优化音乐风格标签
`suno_mashup_lyrics`	混搭歌词
`suno_upload_audio`	上传自定义音频
`suno_add_stem`	为已有音频生成指定乐器或人声音轨
`suno_extract_stem`	提取指定音轨并返回互补版本
`suno_generate_sound`	生成单次或循环音效，可指定 BPM 和调性
`suno_adjust_speed`	调整速度，可选择保持音高
`suno_generate_with_custom_model`	使用已就绪的自定义模型创作，支持纯音乐和自动歌词
`suno_manage_project`	按 action 管理有版本的 Studio 多轨工程
`suno_get_task`	查询单个任务状态
`suno_get_tasks_batch`	批量查询任务状态

使用示例

配置完成后，你可以在 AI 客户端中直接用自然语言调用这些功能，例如：

「帮我生成一首关于夏天的流行音乐」
「把这首歌用爵士风格翻唱一下」
「续写这首歌，从第 30 秒开始」
「生成一首中文歌词，主题是旅行」
「把这首歌的人声分离出来」
「帮我把这首歌转成 MIDI 格式」

高级控制与 Studio 工程

suno_generate_music 支持 variety；suno_generate_custom_music 还支持 max_mode 和 audio_weight。max_mode 采用较高的 API 计费档位，默认不启用，应在用户明确选择增强模式后设置。当前价格以平台服务页为准。 suno_generate_with_custom_model 可使用 instrumental=true 生成纯音乐，或使用 lyric_prompt 自动生成歌词；否则提供 lyric。标题、风格可省略，还可传 negative_tags、vocal_gender、weirdness、style_influence、duration 和 callback_url。显式的 0 控制值会保留。 suno_manage_project 的 request.action 可选 create、retrieve、save、 upload、add_track、generate_track、replace_section、commit_candidate、 remove_track、render。输入按动作区分，工程修改应使用最近回读的 version_id；保存时传完整 state，保留已有轨道和字段。除 retrieve 外，每次调用都必须给出 idempotency_key。新写操作使用新键；超时或受理结果不确定时，保留原键和完全相同的请求重试，或查询原任务，不要自动换键重发收费生成。源音频区间用秒，工程时间线区间用拍数。生成只创建候选，需要选定候选并调用 commit_candidate 才会写入轨道。异步受理的 task_id 用 suno_get_task 查询。finished_at 为空时继续等待，终态后检查 response.success 与错误；不要把受理成功当成生成、提交或导出成功。 suno_get_tasks_batch 返回完整 JSON 任务记录，保留自定义模型对象、工程状态、候选及 MIDI 等各类结果。完整工作流见 Studio 项目指南。

MCP 服务器

功能概览

前置准备

方式一：使用托管 MCP Server（推荐，零安装）

Claude.ai（网页版，OAuth 登录，最简单）

Claude Desktop

Claude Code（终端命令行）

VS Code（GitHub Copilot）

Cursor

其他支持 MCP 的客户端

方式二：本地运行（pip / uvx 安装）

安装

在 Claude Desktop 中使用（本地）

在 VS Code / Cursor 中使用（本地）

可用工具列表

使用示例

更多信息

高级控制与 Studio 工程

​功能概览

​前置准备

​方式一：使用托管 MCP Server（推荐，零安装）

​Claude.ai（网页版，OAuth 登录，最简单）

​Claude Desktop

​Claude Code（终端命令行）

​VS Code（GitHub Copilot）

​Cursor

​其他支持 MCP 的客户端

​方式二：本地运行（pip / uvx 安装）

​安装

​在 Claude Desktop 中使用（本地）

​在 VS Code / Cursor 中使用（本地）

​可用工具列表

​使用示例

​更多信息

​高级控制与 Studio 工程

功能概览

前置准备

方式一：使用托管 MCP Server（推荐，零安装）

Claude.ai（网页版，OAuth 登录，最简单）

Claude Desktop

Claude Code（终端命令行）

VS Code（GitHub Copilot）

Cursor

其他支持 MCP 的客户端

方式二：本地运行（pip / uvx 安装）

安装

在 Claude Desktop 中使用（本地）

在 VS Code / Cursor 中使用（本地）

可用工具列表

使用示例

更多信息

高级控制与 Studio 工程