SunoBoard

@yellowkode/suno-mcp

Suno AI 用 MCP サーバー — Claude、VSCode、Cursor、その他の MCP 対応クライアントから直接音楽を生成できます。

YellowKode Academy 提供 · sunoboard.com

---

これは何ですか？

@yellowkode/suno-mcp は、Claude やその他の AI アシスタントを Suno AI の音楽生成 API に直接接続する、オープンソースの Model Context Protocol（MCP） サーバーです。

API を手動で呼び出す代わりに、Claude に次のように伝えるだけです。

「暗く、アンビエントなバイキング風のインストゥルメンタルを生成してください。ドラムはスローで、シネマティックに。ボーカルはなしで」

……あとは Claude が生成の全工程を自動で処理します。

---

前提条件

• Node.js 18+
• Suno API キー — 次の 2 つの方法があります。

方法	キーの形式	入手先
SunoBoard（推奨）	sb_...	sunoboard.com — 生成した曲はダッシュボードに保存されます
sunoapi.org（BYOK）	abc123...	sunoapi.org → ダッシュボード → API キー

サーバーはキーのプレフィックスに基づいて、使用する API を自動検出します。追加の設定は不要です。

---

クイックスタート

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

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

---

セットアップ

Claude Desktop

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（ターミナル）

claude mcp add suno \
  -e SUNO_API_KEY=your_key_here \
  -- npx @yellowkode/suno-mcp

Cursor / Cline（VSCode）

.cursor/mcp.json または .vscode/mcp.json に追加します。

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

---

利用可能なツール

ツール	説明
generate_music	音楽の生成を開始します — taskId を返します
get_music_status	taskId を指定して生成状況を確認します
wait_for_music	準備ができるまで自動でポーリングし、音声 URL を返します（最大 5 分）
list_recent_music	最近生成したトラックを一覧表示します
get_credits	残りの API クレジットを確認します

SunoBoard のキー（sb_...）を使うと、次のツールも利用できます。

ツール	説明
generate_sfx	テキストから効果音を生成します（足音、コイン、ドア、UI クリック、ヒューッという音など）。長さは 0.5～10 秒で、約 2 秒で完成します。public: true を指定すると、SunoBoard Discover でも共有されます
list_models	音楽および効果音モデル（Suno、Google Lyria、MiniMax、Stable Audio、ElevenLabs、TangoFlux）と、それぞれの料金を一覧表示します
get_usage	今月の残りクレジット数と効果音の生成可能数、リセット日、デフォルトのモデルを確認します
search_library	SunoBoard の公開ライブラリから、すぐに使えるトラックを検索します（無料）
get_referral_link	紹介リンクを取得します（あなたと友人の両方にボーナスクレジットが付与されます）

SunoBoard のキーを使うと、generate_music では model に lyria-3-pro、minimax-2.6、stable-audio-2.5、elevenlabs-music も指定できます（対応している場合は duration_seconds も指定できます）。キーは sunoboard.com/settings で取得できます。インストールせずに使うには、ホスト型コネクター https://mcp.sunoboard.com/mcp を追加してください（ガイド）。

generate_music のパラメーター

パラメーター	型	デフォルト	説明
prompt	string	必須	音楽の説明または歌詞（カスタムモードの場合）
model	string	V4_5	V4 · V4_5 · V4_5PLUS · V4_5ALL · V5 · V5_5
style	string	—	スタイルタグ。例："ambient dark, slow drums"
title	string	—	トラックのタイトル（カスタムモードでは必須）
instrumental	boolean	false	ボーカルなしで生成します
customMode	boolean	false	prompt をそのまま歌詞として使用します
vocalGender	"male" | "female"	—	ボーカルの希望（カスタムモードのみ）
negativeTags	string	—	避けるスタイル。例："heavy metal"
styleWeight	0–1	0.5	スタイルへの準拠度
weirdnessConstraint	0–1	0.5	創造性と予測しやすさのバランス
audioWeight	0–1	0.5	音質の重み

---

使用例

基本

「勉強中に聴くための、リラックスできるローファイ・ヒップホップのトラックを生成して」

Claude が generate_music → wait_for_music を呼び出し、音声 URL を返します。

ゲーム開発

「RPG のボス戦向けに、ドラマチックな戦闘音楽を生成して。オーケストラ風、歌詞なし、激しい雰囲気で」

ゲーム用の効果音（SunoBoard のキー）

「20 種類の音のリスト（草の上を歩く足音、コイン取得音、ドアのきしむ音など）です。それぞれ generate_sfx で生成して、assets/audio/sfx に保存して」

カスタム歌詞

「次の歌詞で曲を生成して：[歌詞を貼り付け]、スタイル：インディーポップ、女性ボーカル」

詳細な指定

「音楽を生成して：prompt='cosmic meditation'、style='deep space ambient, synth pads'、model=V5、インストゥルメンタル、weirdness=0.7」

---

環境変数

変数	必須	デフォルト	説明
SUNO_API_KEY	✅	—	API キー（sb_... または sunoapi.org のハッシュ）
SUNO_API_BASE_URL	❌	自動検出	API のベース URL を上書きします
MAX_POLL_ATTEMPTS	❌	30	wait_for_music の最大ポーリング回数
POLL_INTERVAL_MS	❌	10000	ポーリング間隔（ミリ秒）

---

ビジュアルダッシュボード

生成した音楽をすべてビジュアルで管理しませんか？

SunoBoard では、次のことができます。

• インラインプレーヤー付きの全履歴を確認
• プロジェクト別に整理（例：「ゲーム OST」、「YouTube チャンネル」）
• MP3 をダウンロード
• クレジットを追跡
• 同じパラメーターで再生成

sb_ キーを使用すると、生成した音楽がすべて自動的にダッシュボードに表示されます。

---

コントリビューション

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

テスト：npm test

---

ライセンス

MIT © YellowKode Academy · Wunka Tech

Kelvin Biffi が ❤️ を込めて作成