Suno APIを用いたAI音楽生成機能を提供するモデルコンテキストプロトコル(MCP)サーバー。 このサーバーでは、Claude やその他の MCP クライアントが音楽を生成したり、トラック情報を取得したり、シンプルなツールインターフェイスで API クレジットを管理したりすることができます。

✨ GitHub Actions で自動 Docker ビルド機能 - docker pull で最新版を入手!

##特徴

-音楽を生成する:カスタマイズ可能なパラメータでテキストプロンプトからAI生成音楽を作成

• WAV変換:生成されたMP3トラックを高品質のWAV形式に変換 -Track Status Monitoring: タスクIDを使用して、生成の進捗状況を確認し、完了した追跡情報を取得します。
• 追跡情報: トラックIDを使用してステータス、URL、メタデータを含む生成されたトラックに関する詳細情報を取得します。
• クレジット管理: API のクレジット残高と使用状況の統計を確認する -マルチプルモデルバージョン: Suno v3.5、v4、v4.5、v4.5plus、v5、v5.5モデルのサポート(最高の品質のために推奨v5.5)
• カスタムモード:正確な歌詞、特定のジャンルタグ、および高度な制御による微調整生成

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