跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

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

​
更多信息