English Français العربية

SunoBoard

السجل الرسمي الألعاب والرياضة والترفيه

AI music and sound effects for games and videos: Suno, Lyria, Stable Audio, MiniMax, ElevenLabs.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http sunoboard 'https://mcp.sunoboard.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "sunoboard": {
            "type": "http",
            "url": "https://mcp.sunoboard.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @yellowkode/suno-mcp
  2. What is this?
  3. Prerequisites
  4. Quick start
  5. Setup
  6. Available Tools
  7. Usage Examples
  8. Environment Variables
  9. Visual Dashboard
  10. Contributing
  11. License

@yellowkode/suno-mcp

MCP Server for Suno AI — Generate music directly from Claude, VSCode, Cursor, and any MCP-compatible client.

by YellowKode Academy · sunoboard.com

What is this?

@yellowkode/suno-mcp is an open-source Model Context Protocol (MCP) server that connects Claude and other AI assistants directly to the Suno AI music generation API.

Instead of manually calling the API, you can just tell Claude:

"Generate a dark ambient viking instrumental, slow drums, cinematic, no vocals"

...and Claude handles the full generation flow automatically.

Prerequisites

  • Node.js 18+
  • A Suno API key — two options:
OptionKey formatWhere to get
SunoBoard (recommended)sb_...sunoboard.com — generations saved to your dashboard
sunoapi.org (BYOK)abc123...sunoapi.org → Dashboard → API Keys

The server auto-detects which API to use based on the key prefix. No extra config needed.

Quick start

# One-shot (no install needed)
SUNO_API_KEY=your_key npx @yellowkode/suno-mcp

# Or install globally
npm install -g @yellowkode/suno-mcp

Setup

Claude Desktop

Edit claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "suno": {
      "command": "npx",
      "args": ["@yellowkode/suno-mcp"],
      "env": {
        "SUNO_API_KEY": "your_key_here"
      }
    }
  }
}
Claude Code (terminal)
claude mcp add suno \
  -e SUNO_API_KEY=your_key_here \
  -- npx @yellowkode/suno-mcp
Cursor / Cline (VSCode)

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "mcpServers": {
    "suno": {
      "command": "npx",
      "args": ["@yellowkode/suno-mcp"],
      "env": {
        "SUNO_API_KEY": "your_key_here"
      }
    }
  }
}

Available Tools

ToolDescription
generate_musicStart music generation — returns a taskId
get_music_statusCheck generation status by taskId
wait_for_musicAuto-poll until ready, returns audio URL (up to 5 min)
list_recent_musicList recently generated tracks
get_creditsCheck remaining API credits

With a SunoBoard key (sb_...) you also get:

ToolDescription
generate_sfxGenerate a sound effect from text (footsteps, coins, doors, UI clicks, whooshes…), 0.5–10 s, ready in ~2 s. Pass public: true to also share it on SunoBoard Discover
list_modelsMusic and SFX models (Suno, Google Lyria, MiniMax, Stable Audio, ElevenLabs, TangoFlux) with what each costs
get_usageCredits and sound effects left this month, reset date, your default models
search_librarySearch the public SunoBoard library of ready-made tracks (free)
get_referral_linkYour referral link (bonus credits for you and a friend)

With a SunoBoard key, generate_music also accepts model = lyria-3-pro, minimax-2.6, stable-audio-2.5 or elevenlabs-music (plus duration_seconds where supported). Get your key at sunoboard.com/settings — or skip the install and add the hosted connector https://mcp.sunoboard.com/mcp (guide).

generate_music parameters
ParameterTypeDefaultDescription
promptstringrequiredMusic description or lyrics (in custom mode)
modelstringV4_5V4 · V4_5 · V4_5PLUS · V4_5ALL · V5 · V5_5
stylestring—Style tags e.g. "ambient dark, slow drums"
titlestring—Track title (required in custom mode)
instrumentalbooleanfalseGenerate without vocals
customModebooleanfalseUse prompt as literal lyrics
vocalGender"male" \"female"—Vocal preference (custom mode only)
negativeTagsstring—Styles to avoid e.g. "heavy metal"
styleWeight0–10.5Style adherence
weirdnessConstraint0–10.5Creativity vs. predictability
audioWeight0–10.5Audio quality weight

Usage Examples

Basic

"Generate a relaxing lo-fi hip hop track for studying"

Claude calls generate_music → wait_for_music and returns the audio URL.

Game development

"Generate dramatic battle music for an RPG boss fight, orchestral, no lyrics, intense"

Sound effects for your game (SunoBoard key)

"Here's my list of 20 sounds (footsteps on grass, coin pickup, door creak…). Generate each one with generate_sfx and save them to assets/audio/sfx"

Custom lyrics

"Generate a song with these lyrics: [paste lyrics], style: indie pop, female vocals"

With full control

"Generate music: prompt='cosmic meditation', style='deep space ambient, synth pads', model=V5, instrumental, weirdness=0.7"

Environment Variables

VariableRequiredDefaultDescription
SUNO_API_KEY✅—Your API key (sb_... or sunoapi.org hash)
SUNO_API_BASE_URL❌auto-detectedOverride API base URL
MAX_POLL_ATTEMPTS❌30Max polls for wait_for_music
POLL_INTERVAL_MS❌10000Polling interval in ms

Visual Dashboard

Want to manage all your generated music visually?

SunoBoard gives you:

  • Full history with inline player
  • Organize by project (e.g. "Game OST", "YouTube Channel")
  • Download MP3
  • Credit tracking
  • Regenerate with same parameters

Use a sb_ key to have all generations appear automatically in your dashboard.

Contributing

git clone https://github.com/YellowKode-Academy/suno-mcp
cd suno-mcp
npm install
npm run dev

Tests: npm test

License

MIT © YellowKode Academy · Wunka Tech

Built with ❤️ by Kelvin Biffi

الأسئلة الشائعة

ما هو SunoBoard؟

AI music and sound effects for games and videos: Suno, Lyria, Stable Audio, MiniMax, ElevenLabs.

كيف أثبّت SunoBoard؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http sunoboard 'https://mcp.sunoboard.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SunoBoard إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل SunoBoard مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون SunoBoard؟

ينشره YellowKode-Academy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.