跳轉到主要內容
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 格式」

​
更多信息