Сервер Model Context Protocol (MCP), который предоставляет возможности генерации музыки с использованием API Suno. Этот сервер позволяет Claude и другим MCP-клиентам генерировать музыку, извлекать информацию о треке и управлять API-кредитами через простой интерфейс инструмента.

** Функции автоматической сборки Docker с помощью GitHub Actions - всегда получайте последнюю версию с docker pull!**

Особенности

Generate Music: Создание музыки, генерируемой ИИ, из текстовых подсказок с настраиваемыми параметрами WAV Conversion: Преобразование сгенерированных MP3-треков в высококачественный формат WAV Мониторинг состояния трека: проверяйте прогресс генерации и извлекайте заполненную информацию трека с помощью идентификаторов задач Информация о поиске: Получите подробную информацию о генерируемых треках, включая статус, URL-адреса и метаданные, используя идентификаторы треков Управление кредитами: Проверьте кредитный баланс API и статистику использования Множественные версии моделей: поддержка моделей Suno v3.5, v4, v4.5, v4.5plus, v5 и v5.5 (v5.5 рекомендуется для лучшего качества) Custom Mode: поколение тонкой настройки с точной лирикой, конкретными жанровыми тегами и расширенными элементами управления

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!

1. Pull the Docker image:

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

2. 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