audial-mcp

audial-mcp

Audial が提供する、ホスト型オーディオツールをあらゆる MCP クライアントから実行できます。ステムの分離、オーディオの分析とセグメント分割、トラックのマスタリング、サンプルパックの作成、オーディオから MIDI への変換、音楽の生成、ワンショットから編集可能な Audial Synth プリセットへの変換、リファレンスボイスでの歌詞の歌唱が可能です。各ツールが呼び出す内容については、API リファレンス をご覧ください。

mcp-name: io.github.AudialAI/audial-mcp

インストール

Audial アカウント（https://audialmusic.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp）と uv が必要です。コピーする API キーはありません。 ツールを初めて実行すると、ブラウザーでサインインページが開きます。承認すると、ツールが続行します。

Claude Code

claude mcp add audial -e AUDIAL_RESULTS_DIR=~/Audial -- uvx audial-mcp

Claude Desktop / Cursor / JSON 設定を使うすべてのクライアント

{
  "mcpServers": {
    "audial": {
      "command": "uvx",
      "args": ["audial-mcp"],
      "env": {
        "AUDIAL_RESULTS_DIR": "~/Audial"
      }
    }
  }
}

サインイン

サインイン情報はコンピューター（~/.audial/credentials.json、読み取れるのは本人のみ）に保存され、 audial コマンドラインと Python SDK で共有されるため、ターミナルで audial login を実行すると MCP サーバーにもサインインできます。2 分以内に承認しなかった場合、ツールはサインインリンクを返します。承認してから、もう一度実行してください。account、sign_in、sign_out ツールでサインイン中のアカウントを確認・変更できます。また、接続済みの各コンピューターは、audialmusic.ai のプロフィールにある Apps & API Keys で一覧表示され、接続を解除できます。

サインインできる人がいないサーバーや CI では、そのページで作成したキーを AUDIAL_API_KEY に設定します。 この方法で設定したキーは、保存済みのサインイン情報より優先されます。

ツール

ツール	機能
stem_split	トラックをボーカル、ドラム、ベース、その他に分離します（任意でタイミングやキーを変更できます）
analyze	BPM、キーなどの特性を分析します
segment	セクションと構成要素を分析します。ステムを分離してからセグメント分割します。1 回の呼び出しで実行できます
master	マスタリングします。任意でリファレンスに合わせられます
generate_samples	トラックからサンプルパックを作成します。ステムを分離してからパックを作成します。1 回の呼び出しで実行できます
generate_midi	オーディオを MIDI に変換します
generate_music	Audial の音楽モデルを使って、テキストからの音楽生成、カバー、リミックス、抽出、補完を行います
sound2vital	ワンショットを編集可能な Audial Synth（Vital）プリセットに変換します
text2vox	歌詞とリファレンスボイスから、歌唱ボーカルと MIDI を生成します
pipeline_status	ID でパイプラインを検索し、状態、各ステップ、これまでの出力を確認します
service_status	現在ワーカーが起動しているツールと、コールドスタートにかかるコストを確認します
list_results	結果フォルダーにある過去の結果を参照します

segment と generate_samples は Audial の パイプライン として実行されます。どちらも分離済みのステムが必要なため、 API はまずステムを分離し、その後、指定されたステップを 1 つのジョブとして実行します。各ステップの開始時と終了時に状況が報告されます（「stem-split completed in 41 s; sample-pack running」）。パイプライン ID は結果の execution_id として返されます。呼び出しがタイムアウトしたジョブの状況を確認するには、この ID を pipeline_status に渡してください。

1音符ごとの歌詞

text2vox は歌詞をメロディーに合わせます。lyrics_mode="per_note" は細かく制御できるモードです。歌詞はパイプ区切りで、MIDIノート1つにつきトークンを1つ指定します。また、ホールドすると、前の音節が次のノートでも続きます。

トークン	意味
grace	このノートで歌います
-	ホールド：前の音節をこのノートまで続けます（ドキュメントに記載されている形式）
+	こちらもホールドです
空	こちらもホールドです。パイプを2つ続けるとこうなります

amazing|-|-|grace|-|how|sweet|the|sound

これにより、ノート1〜3では「amazing」を、ノート4〜5では「grace」を歌います。MIDIファイルにはノートがちょうど9個必要です。休符用のトークンはありません。無音にするノートはMIDIに含めないでください。トークン数はノート数と一致し、最初のトークンは音節でなければなりません。どちらかのルールに違反する歌詞文字列は、アップロード前に、その対象となるノートを示すツールエラーとして返されます（「note 1 has no syllable; the first note needs one (position 1)」）。

コールドスタート

Audial の GPU ワーカーはゼロまでスケールダウンするため、アイドル状態の後に実行する最初のジョブでは、ワーカーの起動とモデルの読み込みに数分余計にかかります。その後のジョブはすべて高速です。Audial はすでにポーリング中のジョブにそのフェーズを報告し、ここにあるすべてのツールは、進行状況の通知とログ行としてその内容を中継します。

Warming up the machine — the first request takes a few minutes longer than usual
(about 3 min); every run after this is faster
Working on your job…

これは、Audial のウェブサイト、CLI、プラグインに表示されるものと同じ文です。service_status を使うと、何かを開始する前に同じ状況を確認できるため、長い待ち時間が発生する理由を事前に説明できます。

お使いのマシンから送信されるデータ

ツールに渡した音声とテキストは、HTTPS 経由で Audial の API（https://api.audialmusic.ai）にアップロードされ、Audial のサーバーで処理されます。結果は AUDIAL_RESULTS_DIR（既定値：~/Audial）にダウンロードされます。それ以外の情報は送信されません。

Audial SDK が参照するため、存在する場合に読み込まれるファイルがほかに2つあります。~/.audial/.audial_config.json と、サーバーの起動元ディレクトリにある .env です。MCP クライアントの設定にある認証情報が常に優先されます。audial-mcp は SDK がいずれかのファイルを読み込む前に環境をスナップショットするため、どちらのファイルも認証情報や API ホストを変更できません。

list_results を除くすべてのツールは Audial API を呼び出します。この API の利用には、アカウントで有効な Audial サブスクリプションが必要です。サブスクリプションがない場合、ツールは API のサブスクリプションに関するメッセージを返します。

設定

変数	必須	既定値
AUDIAL_API_KEY	いいえ	ブラウザーでのサインイン
AUDIAL_USER_ID	いいえ。aud_ で始まらない古い API キーを使用する場合のみ必要
AUDIAL_RESULTS_DIR	いいえ	~/Audial
AUDIAL_JOB_TIMEOUT_S	いいえ	900
AUDIAL_API_BASE_URL	いいえ	本番 API

ライセンス

MIT。ソース：https://github.com/AudialAI/audial-mcp