跳轉到主要內容

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

​
更多信息