Suno-MCP

npm start # 或者，如果您在 package.json 中定义了 "dev" 脚本并希望使用 ts-node-dev 进行热重载开发： # npm run dev # 或者直接运行编译后的 JavaScript 文件： # node build/index.js

{ "YOUR_UNIQUE_SERVER_ID": { // 替换为您客户端生成的唯一 ID "name": "Suno-MCP", // 您为此服务器指定的名称 "type": "stdio", // 通信类型，对于此服务器是 "stdio" "description": "让AI唱歌", // 服务器的简短描述 "isActive": true, // 是否激活此服务器 "command": "node", // 用于启动服务器的命令 "args": [ "<path-to-your-project>/MCP-Suno/build/index.js" // 指向编译后的 index.js 文件的绝对或相对路径 ], "env": { // 环境变量可以传递给服务器进程 // 如果您在此处设置了 SunoKey，它可能会覆盖 config.env 中的值 // "SunoKey": "sk_YOUR_SUNO_API_KEY_FROM_CLIENT_CONFIG" }, "cwd": "<path-to-your-project>/MCP-Suno" // 可选：设置服务器的工作目录，通常是项目根目录 } }

Generates a song using the Suno API. Provide lyrics, style, and title for custom mode, or a description for inspiration mode. Returns the audio URL upon completion. Polling for results may take a few minutes. When returning an audio URL, please use the following HTML format for user convenience: ```html <audio controls> <source src="YOUR_AUDIO_URL_HERE" type="audio/mpeg"> </audio> <br> <a href="YOUR_AUDIO_URL_HERE" download="SONG_TITLE.mp3"> 点击这里下载喵！ </a>

**输入参数 (`inputSchema`):** * `prompt` (string): 歌词内容。自定义模式下必需。示例: `'[Verse 1]\nUnder the starry sky...'` * `tags` (string): 音乐风格标签，逗号分隔。自定义模式下必需。示例: `'acoustic, folk, pop'` * `title` (string): 歌曲标题。自定义模式下必需。示例: `'Starry Night Serenade'` * `mv` (string, 可选): 模型版本。可选值: `"chirp-v3-0"`, `"chirp-v3-5"`, `"chirp-v4"`。默认为 `'chirp-v4'`。 * `make_instrumental` (boolean, 可选): 是否生成纯音乐。默认为 `false`。 * `gpt_description_prompt` (string, 可选): 灵感模式的描述。如果提供此参数，则 `prompt`, `tags`, 和 `title` 不是用户严格要求的。示例: `'A cheerful upbeat song about a sunny day.'` * `task_id` (string, 可选): 要继续的先前歌曲的任务 ID。如果提供，则 `continue_at` 和 `continue_clip_id` 也需要。 * `continue_at` (number, 可选): 从歌曲的哪个时间点（秒）开始继续。需要 `task_id` 和 `continue_clip_id`。 * `continue_clip_id` (string, 可选): 要继续的歌曲片段的剪辑 ID。需要 `task_id` 和 `continue_at`。 **验证逻辑:** * 如果未提供 `gpt_description_prompt`，则 `prompt`, `tags`, 和 `title` 都是必需的。 * 如果提供了 `task_id`，则 `continue_at` 和 `continue_clip_id` 也必须提供。 **输出:** 成功时，返回一个包含音频 URL 的文本内容。如果发生错误，将返回错误信息。 ## 💡 示例 MCP 请求 **生成自定义歌曲:** ```json { "type": "call_tool", "params": { "name": "generate_music_suno", "arguments": { "prompt": "[Verse 1]\nIn the digital realm, where code streams flow,\nA kitty coder, with a vibrant glow.\n[Chorus]\nMeow, meow, MCP, oh so grand,\nGenerating tunes across the land!", "tags": "electronic, upbeat, synthwave", "title": "MCP Kitty's Anthem", "mv": "chirp-v4" } } }

{ "type": "call_tool", "params": { "name": "generate_music_suno", "arguments": { "gpt_description_prompt": "A lofi chill beat for late night coding sessions", "mv": "chirp-v3-5" } } }

{ "type": "call_tool", "params": { "name": "generate_music_suno", "arguments": { "task_id": "your_previous_task_id_here", "continue_at": 60, "continue_clip_id": "your_previous_clip_id_here", "mv": "chirp-v4" // prompt, tags, title might be needed by Suno API for continuation, // or it might infer from the original task. // Check Suno API documentation for specifics on continuation. } } }