codekeanu/suno-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

16 stars 6 forks 품질 67 트렌드 25

Repository Install

Claude Code를 위한 Suno API MCP를 위한 Repo

개요

Suno API를 사용하여 AI 음악 생성 기능을 제공하는 모델 Context Protocol (MCP) 서버. 이 서버는 Claude 및 기타 MCP 클라이언트가 음악을 생성하고 추적 정보를 검색하고 간단한 도구 인터페이스를 통해 API 크레딧을 관리 할 수 있습니다. - : 사용자 정의 매개 변수로 텍스트 프롬프트에서 AI 생성 된 음악 만들기 - : 생성 된 MP3 트랙을 고품질 WAV 형식으로 변환 - : 생성 진행 및 검색 완료 트랙 정보를 사용하여 작업 ID - : 상태, URL 및 트랙 ID를 사용하여 생성 된 트랙에 대한 자세한 정보를 검색 - : API 신용 잔고 및 사용 통계를 확인 - : Suno v3.5, v4, v4.5, v4.5plus, v5 및 v5.5 모델에 대한 지원 (v5), 그리고 v5.5 모델 (v5, 5.5 모델 (v5, 5.5) - 특정 장르에 대한 품질 관리, 우수한 선택, 우수한 선택, 우수한 선택, 우수한 선택, - : Docker 및 Docker Compose 설치 - : Python 3.

개요(AI 번역)

Suno API를 사용하여 AI 음악 생성 기능을 제공하는 모델 Context Protocol (MCP) 서버. 이 서버는 Claude 및 기타 MCP 클라이언트가 음악을 생성하고 추적 정보를 검색하고 간단한 도구 인터페이스를 통해 API 크레딧을 관리 할 수 있습니다.

✨ GitHub Actions를 통해 자동 Docker 빌드 - 항상 최신 버전을 docker pull!

특징

Generate Music: 사용자 정의 매개 변수로 텍스트 프롬프트에서 AI-generated 음악 만들기
WAV 변환: 생성된 MP3 트랙을 고품질 WAV 형식으로 변환
Track Status Monitoring: 작업 ID를 사용하여 생성 진행 및 검색 완료된 트랙 정보를 확인
** 추적 정보**: 상태, URL, 그리고 metadata를 포함한 생성된 트랙에 대한 자세한 정보를 검색
** 신용 관리 **: API 신용 잔고 및 사용 통계 확인
Multiple Model Versions: Suno v3.5, v4, v4.5, v4.5plus, v5 및 v5.5 모델 지원 (최고 품질의 v5.5 권장)
** 사용자 정의 모드**: 정확한 lyrics, 특정 장르 태그 및 고급 컨트롤을 가진 정밀한 톤 생성

이 페이지는 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

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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