メインコンテンツへスキップ
MCP(Model Context Protocol) は、Anthropic によって提唱されたモデルコンテキストプロトコルで、AI モデル(Claude、GPT など)が標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。AceData Cloud が提供する Suno MCP Server を使用することで、Claude Desktop、VS Code、Cursor などの AI クライアントで直接音楽や歌詞を生成し、音声プロジェクトを管理できます。

機能概要

Suno MCP Server は以下のコア機能を提供します:
  • 音楽生成 — テキストプロンプトを通じて AI 音楽を生成
  • カスタム制作 — 歌詞、タイトル、音楽スタイルを完全に制御
  • 曲の続き — 任意の時点から既存の曲を延長
  • カバー/リミックス — 異なるスタイルでカバー版を作成
  • 歌詞生成 — 説明に基づいて構造化された歌詞を生成
  • ボイスキャラクター — 声のスタイルを保存および再利用
  • メディア変換 — MP4、WAV、MIDI、ボーカル分離などを取得
  • スタイル最適化 — 音楽スタイルタグを最適化
  • タスククエリ — 生成進捗を監視し、結果を取得

前提準備

使用する前に、AceData Cloud API トークンを取得する必要があります:
  1. AceData Cloud プラットフォーム に登録またはログイン
  2. Suno Audios API ページに移動
  3. 「Acquire」をクリックして API トークンを取得(初回申請で無料枠をプレゼント)

インストール設定

方法一:pip インストール(推奨)

pip install mcp-suno

方法二:ソースコードインストール

git clone https://github.com/AceDataCloud/MCPSuno.git
cd MCPSuno
pip install -e .
インストールが完了したら、mcp-suno コマンドでサービスを起動できます。

Claude Desktop での使用

Claude Desktop の設定ファイルを編集します:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
以下の設定を追加します:
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
uvx を使用する場合(事前にパッケージをインストールする必要はありません):
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
設定を保存した後、Claude Desktop を再起動すると、対話の中で Suno 関連ツールを使用できるようになります。

VS Code / Cursor での使用

プロジェクトのルートディレクトリに .vscode/mcp.json を作成します:
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
または uvx を使用する場合:
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

利用可能なツール一覧

ツール名説明
suno_generate_musicテキストプロンプトを通じて音楽を生成
suno_generate_custom_musicカスタム歌詞とスタイルで音楽を生成
suno_extend_music指定した時点から曲を続ける
suno_cover_musicカバー版を作成
suno_concat_music曲の断片をつなげる
suno_generate_with_persona指定したボイスキャラクターで音楽を生成
suno_remaster_musicリマスタリング
suno_stems_musicトラックを分離(ボーカル/伴奏)
suno_replace_section曲の指定した部分を置き換える
suno_upload_extend音声をアップロードして続ける
suno_upload_cover音声をアップロードしてカバーする
suno_mashup_music複数の曲をミックス
suno_generate_lyrics説明に基づいて歌詞を生成
suno_create_personaボイスキャラクターを作成
suno_get_mp4曲の MP4 ビデオを取得
suno_get_timing歌詞のタイムラインを取得
suno_extract_vocalsボーカルを抽出
suno_get_wav高品質 WAV を取得
suno_get_midiMIDI ファイルを取得
suno_optimize_style音楽スタイルタグを最適化
suno_mashup_lyrics歌詞をミックス
suno_upload_audioカスタム音声をアップロード
suno_get_task単一タスクの状態を確認
suno_get_tasks_batchタスクの状態を一括確認

使用例

設定が完了したら、AI クライアントで自然言語を使ってこれらの機能を直接呼び出すことができます。例えば:
  • 「夏に関するポップ音楽を生成して」
  • 「この曲をジャズスタイルでカバーして」
  • 「この曲を30秒から続けて」
  • 「旅行をテーマにした中国語の歌詞を生成して」
  • 「この曲のボーカルを分離して」
  • 「この曲を MIDI 形式に変換して」

さらなる情報