跳转到主要内容
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：
  1. 注册或登录 AceData Cloud 平台
  2. 前往 Suno Audios API 页面
  3. 点击「Acquire」获取 API Token（首次申请赠送免费额度）

​
安装配置

​
方式一：pip 安装（推荐）

pip install mcp-suno

​
方式二：源码安装

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 格式」

​
更多信息