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（首次申请赠送免费额度）

安装配置

方式一：pip 安装（推荐）

1	pip install mcp-suno

方式二：源码安装

1
2
3

git clone https://github.com/AceDataCloud/MCPSuno.git
cd MCPSuno
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，即可在对话中使用 Suno 相关工具。

在 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_get_task`	查询单个任务状态
`suno_get_tasks_batch`	批量查询任务状态

使用示例

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

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

静觅崔庆才的个人站点 - Python爬虫教程