> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno MCP 接続ガイド

> suno MCP 服务器集成

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

## 機能概要

Suno MCP Server は以下のコア機能を提供します：

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

## 前提準備

使用する前に、XHuoAPI API トークンを取得する必要があります：

1. [XHuoAPI プラットフォーム](https://api.xhuoapi.ai) に登録またはログイン
2. [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios) ページに移動
3. 「Acquire」をクリックして API トークンを取得（初回申請で無料枠をプレゼント）

## インストール設定

### 方法一：pip インストール（推奨）

```bash theme={null}
pip install mcp-suno
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/SunoMCP.git
cd SunoMCP
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`

以下の設定を追加します：

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

`uvx` を使用する場合（事前にパッケージをインストールする必要はありません）：

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

設定を保存した後、Claude Desktop を再起動すると、対話の中で Suno 関連ツールを使用できるようになります。

## VS Code / Cursor での使用

プロジェクトのルートディレクトリに `.vscode/mcp.json` を作成します：

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

または `uvx` を使用する場合：

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_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_midi`              | MIDI ファイルを取得        |
| `suno_optimize_style`        | 音楽スタイルタグを最適化        |
| `suno_mashup_lyrics`         | 歌詞をミックス             |
| `suno_upload_audio`          | カスタム音声をアップロード       |
| `suno_get_task`              | 単一タスクの状態を確認         |
| `suno_get_tasks_batch`       | タスクの状態を一括確認         |

## 使用例

設定が完了したら、AI クライアントで自然言語を使ってこれらの機能を直接呼び出すことができます。例えば：

* 「夏に関するポップ音楽を生成して」
* 「この曲をジャズスタイルでカバーして」
* 「この曲を30秒から続けて」
* 「旅行をテーマにした中国語の歌詞を生成して」
* 「この曲のボーカルを分離して」
* 「この曲を MIDI 形式に変換して」

## さらなる情報

* GitHub リポジトリ：[XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* PyPI パッケージ：[mcp-suno](https://pypi.org/project/mcp-suno/)
* API ドキュメント：[Suno 音楽生成 API](https://api.xhuoapi.ai/documents/suno)