suno-mcp

RunAPI Suno MCP サーバー

AI エージェントから Suno API にアクセス：マルチモーダル生成の実行、非同期結果のポーリング、料金の確認を、目的に特化した 1 つの MCP サーバーで行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換ホストで動作します。}

インストール | ツール | モデル | エージェント向けプロンプト | 設定 | リンク

---

このパッケージを選ぶ理由

@runapi.ai/suno-mcp は、RunAPI の Suno モデル群に特化した Model Context Protocol サーバーです。 RunAPI のカタログ全体を読み込むことなく、MCP 互換アシスタントから 18 個のエンドポイントと 9 種類のモデルに直接アクセスできます。

エージェントの対象を Suno に限定する場合は、このモデル専用サーバーを使用してください。1 つのアシスタントで RunAPI のすべてのモデル群を検出する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します：

claude mcp add suno -s user -- npx -y @runapi.ai/suno-mcp

サーバーをリポジトリ内で共有する場合は、プロジェクトスコープを使用します：

claude mcp add suno -s project -- npx -y @runapi.ai/suno-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code、およびその他の MCP ホストでは、同じ stdio コマンドを使用できます：

{
  "mcpServers": {
    "suno": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/suno-mcp"]
    }
  }
}

サインイン前でも check_pricing は利用できます。タスクの作成とステータスのポーリングを行うには、アシスタントに login ツールを呼び出すよう依頼してください。ブラウザでログイン画面が開き、runapi login が使用するファイルと同じ ~/.config/runapi/config.json に認証情報が保存されます。 ヘッドレス環境や CI ホストでも、MCP ホストの起動前に RUNAPI_API_KEY を設定すれば利用できます。

Claude、Cursor、Windsurf、VS Code、Roo Code 向けのすぐに使える例は、examples/ にあります。

---

ツール

ツール	認証	目的
convert_audio	はい	Suno の音声変換タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
blend_lyrics	はい	Suno の歌詞ブレンドタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、結果ペイロードを返します。
cover_audio	はい	Suno の音声カバータスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
create_mashup	はい	Suno のマッシュアップ作成タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
extend_music	はい	Suno の楽曲拡張タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
generate_lyrics	はい	Suno の歌詞生成タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、結果ペイロードを返します。
inspire_music	はい	Suno の楽曲インスピレーションタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
add_samples	はい	Suno のサンプル追加タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
visualize_music	はい	Suno の楽曲可視化タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
generate_persona	はい	Suno のペルソナ生成操作を同期的に実行します。操作結果を返します。
remaster_audio	はい	Suno の音声リマスタータスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
separate_audio_stems	はい	Suno の音声ステム分離タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
stitch_audio	はい	Suno の音声結合タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
boost_style	はい	Suno のスタイル強化操作を同期的に実行します。操作結果を返します。
text_to_music	はい	Suno のテキストから音楽を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_sound	はい	Suno のテキストからサウンドを生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_timestamped_lyrics	はい	Suno のタイムスタンプ付き歌詞取得操作を同期的に実行します。操作結果を返します。
generate_voice	はい	Suno の音声生成操作を同期的に実行します。操作結果を返します。
get_task	はい	既存タスクの現在のステータスと最新のペイロードを取得します。
check_pricing	いいえ	Suno のモデルとエンドポイントの現在の料金を調べます。

---

モデル

Suno は 18 個のエンドポイントで 9 種類のモデルバリアントに対応しています。各ツールで使用できるモデルは次のとおりです。

ツール	モデル
convert_audio	モデルパラメーターなし
blend_lyrics	モデルパラメーターなし
cover_audio	suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5, suno-v6, suno-v6-mini, suno-v6-wild
create_mashup	suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5, suno-v6, suno-v6-mini, suno-v6-wild
extend_music	suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5, suno-v6, suno-v6-mini, suno-v6-wild
generate_lyrics	モデルパラメーターなし
inspire_music	suno-v4, suno-v4.5, suno-v4.5-plus, suno-v5, suno-v5.5
add_samples	suno-v4, suno-v4.5, suno-v4.5-plus, suno-v5, suno-v5.5
visualize_music	モデルパラメーターなし
generate_persona	モデルパラメーターなし
remaster_audio	suno-v4, suno-v4.5, suno-v4.5-plus, suno-v5, suno-v5.5
separate_audio_stems	モデルパラメーターなし
stitch_audio	suno-v4, suno-v4.5, suno-v4.5-plus, suno-v5, suno-v5.5
boost_style	モデルパラメーターなし
text_to_music	suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5, suno-v6, suno-v6-mini, suno-v6-wild
text_to_sound	suno-v5, suno-v5.5
get_timestamped_lyrics	モデルパラメーターなし
generate_voice	モデルパラメーターなし

モデルの提供状況はリリースごとに変わる場合があります。現在のカタログを確認するには、check_pricing または Suno モデルページ をご利用ください。

---

エージェント向けプロンプト

アシスタントに自然言語で依頼すると、料金を確認し、タスクを作成して、タスク ID と出力 URL を返します。

タスクを作成する

Run a Suno convert audio task with RunAPI.

アシスタントは check_pricing を呼び出してから convert_audio を実行し、タスク ID、ステータス、出力 URL を返します。

待たずに送信する

Create the task but don't wait for it to finish.

アシスタントは wait: false を指定して作成ツールを呼び出し、タスク ID を返します。後で get_task を使って状況を確認できます。

作成前に料金を確認する

Check current Suno pricing, then create the task if it matches my request.

アシスタントは check_pricing を呼び出し、正式なカタログ項目として Suno モデルページ を案内できます。

---

設定

サーバーは次の順序で認証情報を確認します。

1. RUNAPI_API_KEY 環境変数。ヘッドレスホストや CI ホストで便利です
2. ~/.config/runapi/config.json。MCP の login ツールまたは runapi login によって作成されます
3. キーなし。この場合も check_pricing は利用できます

通常、設定ファイルはログインによって管理されます。事前に設定されたヘッドレス環境用の設定では、次のように指定できます。

{
  "apiKey": "your_runapi_key"
}

実際の API キーをコミットしないでください。

---

リンク

リソース	URL
Suno モデルページ	https://runapi.ai/models/suno
npm パッケージ	@runapi.ai/suno-mcp
GitHub リポジトリ	runapi-ai/suno-mcp
RunAPI MCP の概要	runapi.ai/mcp
RunAPI ドキュメント	runapi.ai/docs

---

ライセンス

Apache License, Version 2.0 の下でライセンスされています。