suno-mcp

本地服务

github.com/runapi-ai媒体与设计11 周前更新

代码仓库

关于 suno-mcp

面向 Suno 的专用 RunAPI MCP 服务，为兼容 MCP 的 AI Agent 提供音乐与音频操作、任务跟踪及定价查询。

主要功能

01根据文本生成音乐
02转换、翻唱、扩展和修复音频
03生成歌词和声音
04创建混搭并处理音轨
05查询任务状态和定价

适用场景

01根据文本提示创建音乐
02改编、扩展或修复音频曲目
03在音乐工作流中生成歌词或声音
04查看任务结果和价格

MCP 相关

向 MCP 客户端提供 Suno 生成与音频操作工具、任务状态查询和定价查询，覆盖 18 个端点和 9 种模型变体。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "runapi-builder-suno": {
      "command": "npx",
      "args": [
        "-y",
        "@runapi.ai/suno-mcp"
      ],
      "env": {
        "RUNAPI_API_KEY": "<RUNAPI_API_KEY>"
      }
    }
  }
}

启动命令npx -y @runapi.ai/suno-mcp

需要配置的环境变量

RUNAPI_API_KEY密钥Optional RunAPI API key for headless hosts. Interactive MCP hosts can use the login tool, which writes shared RunAPI config.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@runapi.ai/suno-mcp0.4.2stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
force	boolean	否	当当前凭据来自本地配置文件时，重新运行浏览器登录。

详细介绍

RunAPI Suno MCP 服务

为 AI Agent 提供 Suno API 访问能力：通过一个专用 MCP 服务执行多模态生成操作、轮询异步结果并查询价格。

_{可与 Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code 及任何兼容 MCP 的宿主配合使用。}

安装 | 工具 | 模型 | Agent 提示词 | 配置 | 链接

为什么选择此软件包？

@runapi.ai/suno-mcp 是一个专为 RunAPI Suno 模型系列打造的 Model Context Protocol 服务。它让兼容 MCP 的助手无需加载完整的 RunAPI 目录，即可直接访问 18 个端点和 9 种模型变体。

当 Agent 需要专注于 Suno 时，请使用此单模型服务。当一个助手需要发现所有 RunAPI 模型系列时，请使用 @runapi.ai/mcp。

安装

将其添加到 Claude Code：

claude mcp add suno -s user -- npx -y @runapi.ai/suno-mcp

若要让此服务与某个仓库共享，请使用项目范围：

claude mcp add suno -s project -- npx -y @runapi.ai/suno-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code 和其他 MCP 宿主可以使用相同的 stdio 命令：

{
  "mcpServers": {
    "suno": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/suno-mcp"]
    }
  }
}

无需登录即可使用 check_pricing。如需创建任务并轮询状态，请让你的助手调用 login 工具。该工具会打开浏览器登录，并将凭据保存到 ~/.config/runapi/config.json，此文件也由 runapi login 使用。无头环境和 CI 宿主仍可在启动 MCP 宿主前设置 RUNAPI_API_KEY。

examples/ 中提供了适用于 Claude、Cursor、Windsurf、VS Code 和 Roo Code 的现成示例。

工具

工具	认证	用途
`convert_audio`	是	创建 Suno 音频转换任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`blend_lyrics`	是	创建 Suno 歌词融合任务，并可选择等待任务进入终止状态。返回任务 ID、状态和结果负载。
`cover_audio`	是	创建 Suno 音频翻唱任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`create_mashup`	是	创建 Suno 混搭任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`extend_music`	是	创建 Suno 音乐扩展任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`generate_lyrics`	是	创建 Suno 歌词生成任务，并可选择等待任务进入终止状态。返回任务 ID、状态和结果负载。
`inspire_music`	是	创建 Suno 音乐灵感任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`add_samples`	是	创建 Suno 添加采样任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`visualize_music`	是	创建 Suno 音乐可视化任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`generate_persona`	是	同步运行 Suno 角色生成操作。返回操作结果。
`remaster_audio`	是	创建 Suno 音频重制任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`separate_audio_stems`	是	创建 Suno 音轨分离任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`stitch_audio`	是	创建 Suno 音频拼接任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`boost_style`	是	同步运行 Suno 风格增强操作。返回操作结果。
`text_to_music`	是	创建 Suno 文本转音乐任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`text_to_sound`	是	创建 Suno 文本转声音任务，并可选择等待任务进入终止状态。返回任务 ID、状态和输出 URL。
`get_timestamped_lyrics`	是	同步运行 Suno 获取带时间戳歌词操作。返回操作结果。
`generate_voice`	是	同步运行 Suno 语音生成操作。返回操作结果。
`get_task`	是	获取现有任务的当前状态和最新负载。
`check_pricing`	否	查询 Suno 模型和端点的当前定价。

模型

Suno 涵盖 9 种模型变体和 18 个端点。每个工具都接受其列出的模型：

工具	模型
`convert_audio`	无模型参数
`blend_lyrics`	无模型参数
`cover_audio`	`suno-v4`, `suno-v4.5`, `suno-v4.5-all`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`, `suno-v6`, `suno-v6-mini`, `suno-v6-wild`
`create_mashup`	`suno-v4`, `suno-v4.5`, `suno-v4.5-all`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`, `suno-v6`, `suno-v6-mini`, `suno-v6-wild`
`extend_music`	`suno-v4`, `suno-v4.5`, `suno-v4.5-all`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`, `suno-v6`, `suno-v6-mini`, `suno-v6-wild`
`generate_lyrics`	无模型参数
`inspire_music`	`suno-v4`, `suno-v4.5`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`
`add_samples`	`suno-v4`, `suno-v4.5`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`
`visualize_music`	无模型参数
`generate_persona`	无模型参数
`remaster_audio`	`suno-v4`, `suno-v4.5`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`
`separate_audio_stems`	无模型参数
`stitch_audio`	`suno-v4`, `suno-v4.5`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`
`boost_style`	无模型参数
`text_to_music`	`suno-v4`, `suno-v4.5`, `suno-v4.5-all`, `suno-v4.5-plus`, `suno-v5`, `suno-v5.5`, `suno-v6`, `suno-v6-mini`, `suno-v6-wild`
`text_to_sound`	`suno-v5`, `suno-v5.5`
`get_timestamped_lyrics`	无模型参数
`generate_voice`	无模型参数

不同版本发布时，可用模型可能会发生变化。请使用 check_pricing 或 Suno 模型页面查看当前目录。

Agent 提示词

用自然语言向助手提出请求；它可以查看定价、创建任务，并返回任务 ID 和输出 URL。

创建任务

Run a Suno convert audio task with RunAPI.

助手可以调用 check_pricing，然后调用 convert_audio，并返回任务 ID、状态和输出 URL。

提交任务但不等待

Create the task but don't wait for it to finish.

助手调用创建工具并设置 wait: false，然后返回任务 ID。之后可通过 get_task 查看任务状态。

创建前查看定价

Check current Suno pricing, then create the task if it matches my request.

助手调用 check_pricing，并可链接到 Suno 模型页面查看权威目录条目。

配置

服务按以下顺序解析身份验证信息：

RUNAPI_API_KEY 环境变量，适用于无头主机和 CI 主机
~/.config/runapi/config.json，由 MCP login 工具或 runapi login 创建
没有密钥，此时仍可使用 check_pricing

配置文件通常由登录流程管理。预先配置的无头配置可采用以下形式：

{
  "apiKey": "your_runapi_key"
}

请勿提交真实的 API 密钥。

链接

资源	URL
Suno 模型页面	https://runapi.ai/models/suno
npm 包	@runapi.ai/suno-mcp
GitHub 仓库	runapi-ai/suno-mcp
RunAPI MCP 概览	runapi.ai/mcp
RunAPI 文档	runapi.ai/docs

许可证

根据 Apache License, Version 2.0 授权。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

suno-mcp

关于 suno-mcp

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

RunAPI Suno MCP 服务

为什么选择此软件包？

安装

工具

模型

Agent 提示词

创建任务

提交任务但不等待

创建前查看定价

配置

链接

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？