codekeanu/suno-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

16 stars 6 forks 质量 67 趋势 25

Repository Install

Claude 代码的 Suno API MCP 检索

概览

一个模型上下文协议(MCP)服务器,使用Suno API提供AI音乐生成能力. 这个服务器可以让克洛德和其他MCP客户端通过简单的工具接口生成音乐,取回音轨信息并管理API信用. - :用可自定义参数从文本提示创建AI生成的音乐 - :将生成的MP3音轨转换为高质量的WAV格式 - :通过任务ID检查生成进度并检索已完成的音轨信息 - :利用音轨ID获取关于生成音轨的详细信息,包括状态,URL,以及元数据 - :检查API信用平衡和使用统计 - 支持Suno v3.5,v4,v4.5,v4.5plus,v5和v5.5模型 (为最佳质量推荐的v5.5) - :精细调生成,精确的歌词,特定的流派标记,以及高级控制 - :样式加权,怪异性约束,声性别选择等更多 - :多克和多克编曲安装 -:Python 3.

概述（AI 翻译）

一个模型上下文协议(MCP)服务器,使用Suno API提供AI音乐生成能力. 这个服务器可以让克洛德和其他MCP客户端通过简单的工具接口生成音乐,取回音轨信息并管理API信用.

QQ 特性自动多克通过 GitHub 动作构建 - 总是用 [[T0] 获取最新版本 ! **

□ 特性

Generate Music:用自定义参数从文本提示创建AI生成的音乐
WAV转换:将生成的MP3音轨转换为高质量的WAV格式
** 跟踪状态监测**:利用任务ID检查生成进度并检索已完成的跟踪信息
追踪资料**: 使用音轨ID获取关于生成音轨的详细信息,包括状态、 URL 和元数据
** 信用管理**: 检查 API 信用余额和使用统计
多式模型版本:支持Suno v3.5,v4,v4.5,v4.5plus,v5和v5.5模型(推荐最佳质量)
** Custom Mode**: 精细调值的生成,带有精确的歌词,特定的流派标记和高级控制

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Suno MCP Server

A Model Context Protocol (MCP) server that provides AI music generation capabilities using the Suno API. This server allows Claude and other MCP clients to generate music, retrieve track information, and manage API credits through a simple tool interface.

✨ Features automatic Docker builds via GitHub Actions - always get the latest version with docker pull!

Features

Generate Music: Create AI-generated music from text prompts with customizable parameters
WAV Conversion: Convert generated MP3 tracks to high-quality WAV format
Track Status Monitoring: Check generation progress and retrieve completed track information using task IDs
Track Information: Retrieve detailed information about generated tracks including status, URLs, and metadata using track IDs
Credit Management: Check API credit balance and usage statistics
Multiple Model Versions: Support for Suno v3.5, v4, v4.5, v4.5plus, v5, and v5.5 models (v5.5 recommended for the best quality)
Custom Mode: Fine-tune generation with exact lyrics, specific genre tags, and advanced controls
Advanced Controls: Style weighting, weirdness constraint, vocal gender selection, and more

Prerequisites

Option 1 (Docker - Recommended): Docker and Docker Compose installed
Option 2 (Native Python): Python 3.10 or higher
A Suno API key (obtain from sunoapi.org)
An MCP-compatible client: Claude Desktop or Claude Code

Installation

Option 1: Docker Pull (Easiest - Recommended)

Pull the pre-built image directly from GitHub Container Registry - no code or build required!

Pull the Docker image:

docker pull ghcr.io/codekeanu/suno-mcp:latest

Create a .env file with your API key:

# Create a directory for your config
mkdir suno-mcp-config
cd suno-mcp-config

# Create .env file
cat > .env << EOF
SUNO_API_KEY=your_actual_api_key_here
SUNO_API_BASE_URL=https://api.sunoapi.org
EOF

That’s it! Skip to the Usage section to configure Claude Desktop or Claude Code.

Option 2: Docker Build from Source

在 GitHub 查看完整 README

安装

docker run --rm -i --env-file /absolute/path/to/.env ghcr.io/codekeanu/suno-mcp:latest

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "suno": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/absolute/path/to/.env",
        "ghcr.io/codekeanu/suno-mcp:latest"
      ]
    }
  }
}