MCP Audio Studio

MCP Audio Studio

MCP サーバーおよび MCP App として提供される、インタラクティブなデジタルオーディオワークステーションです。FL スタイルのチャンネルラック、ピアノロール、プレイリスト、ミキサー、エフェクト、オートメーション、プラグインスロット、オーディオファイルトラック、マイク録音、オフライン WAV レンダリングをひとつのパッケージにまとめています。

モデルとユーザーは、同じ信頼できるプロジェクトを使用します。UI のすべての操作は MCP ツールを呼び出し、モデル側の編集はすべて、リビジョンのポーリングを通じて開いているスタジオに表示されます。

利用できる機能

• テンポ、拍子、スウィング、メトロノーム、ループ、再生／停止、マイク録音のコントロール。
• 16 ステップのチャンネルラックとクロマチックピアノロールを備えた、インストゥルメントトラックとオーディオトラック。
• オーディオファイルのインポート、クリップの配置、ゲイン／トリムのメタデータ、ブラウザーでの再生。
• チャンネルごとおよびマスターの音量、パン、ミュート、ソロ、センド、アニメーションメーター。
• 4 バンドイコライザーと、フィルター、ディレイ、リバーブ、ディストーション、コンプレッサー、コーラス、リミッターのスロット。
• マスター／トラックのミキシング、EQ、センド、組み込みエフェクト、インストゥルメントパラメーター、数値指定のプラグインパラメーターを対象とする、再生およびレンダリング用のオートメーション。リニア、ホールド、スムーズな制御ポイントに対応しています。
• 組み込み DSP スロット、ブラウザーで安全に使用できる Web Audio Module（WAM）スロット、VST3 の制御／状態スロット。
• 純粋な JavaScript によるステレオ WAV レンダリング。再生可能な MCP オーディオコンテンツとして返されます。
• プロジェクトの保存、インポート、エクスポート。
• stdio、Streamable HTTP、HTTPS トランスポート。
• HTTP／HTTPS サーバーのルートで動作するスタンドアロンのブラウザーモード。

実行方法

npm と npx を使用（推奨）

このパッケージは npm で公開されています。Node.js 18 以降では、リポジトリをインストールまたはクローンせずに実行できます。

# MCP stdio
npx -y mcp-audio-studio@latest --stdio

# HTTP MCP endpoint + standalone studio
npx -y mcp-audio-studio@latest --http --port 3100

HTTP スタジオは http://127.0.0.1:3100/ で開きます。MCP エンドポイントは http://127.0.0.1:3100/mcp です。

単体の実行ファイル

GitHub Releases から、Windows、macOS、Linux 用の実行ファイルをダウンロードしてください。サーバー、MCP App、ランタイム、JavaScript の依存関係が含まれています。

# MCP stdio
./mcp-audio-studio-windows-x64.exe --stdio

# HTTPS MCP endpoint + standalone studio
./mcp-audio-studio-windows-x64.exe --https --port 3100

証明書が設定されていない場合、HTTPS モードでは一時的な自己署名の localhost 証明書が作成されます。信頼された証明書を使用するには、MCP_AUDIO_STUDIO_TLS_CERT と MCP_AUDIO_STUDIO_TLS_KEY を設定してください。

ソースから実行

チェックアウトしたリポジトリからローカル開発を行う場合：

npm install
npm run build
node ./dist/index.js --stdio
node ./dist/index.js --http --port 3100

MCP クライアントの設定

個別にインストールせずに、MCP クライアントで npm パッケージを使用します。

{
  "mcpServers": {
    "audio-studio": {
      "command": "npx",
      "args": ["-y", "mcp-audio-studio@latest", "--stdio"]
    }
  }
}

チェックアウトしたリポジトリを使用する場合：

{
  "mcpServers": {
    "audio-studio": {
      "command": "node",
      "args": ["./dist/index.js", "--stdio"]
    }
  }
}

ダウンロードした実行ファイルを使用する場合は、command を実行ファイルの絶対パスに置き換え、args に ["--stdio"] を指定してください。

スタジオを表示するには studio_ui を呼び出します。このツールは _meta.ui.resourceUri = "ui://audio-studio/studio-v1.html" を宣言しており、リソースではポータブルな text/html;profile=mcp-app MIME タイプと MCP Apps ブリッジを使用します。

MCP ツール

領域	ツール
スタジオとプロジェクト	studio_ui、get_project、new_project、set_project、import_project、export_project
トランスポート	set_transport
トラックとノート	add_track、update_track、remove_track、set_steps
オーディオクリップ	add_audio_clip、update_audio_clip、remove_audio_clip
ミキシング	set_mixer、set_equalizer
エフェクト	add_effect、update_effect、remove_effect
プラグイン	add_plugin、update_plugin、remove_plugin
オートメーション	upsert_automation、remove_automation
レンダリング	render_audio、get_render

すべてのデータツールは UI なしで動作し、モデルが読み取れるテキストと構造化コンテンツを返します。studio_ui は専用の表示ツールであり、不要な iframe の再マウントを避けます。

VST3 と WAM のサポート

MCP Apps はサンドボックス化されたブラウザー iframe で実行されるため、ネイティブの .dll、.so、.vst3 バイナリを読み込めません。そのため、このリリースでは次の機能を提供します。

• ブラウザーで安全に使用できるプラグインモジュール向けの WAM URL スロット。
• パス、有効化／バイパス、パラメーター、不透明な状態、オートメーションのターゲットを備えた VST3 スロット。
• 将来のネイティブプラグインホストブリッジを想定した、安定したプロジェクト／ツール表現。

同梱の Web Audio エンジンとオフラインレンダリングエンジンは、組み込みの楽器／エフェクトを処理します。このリリースではネイティブ VST3 の DSP は実行されません。別の形で表現すると、安全性を損ない、技術的にも不正確になるためです。ネイティブブリッジでは、各プラグインを個別のプロセスで分離し、ライセンスされた VST3 ホスティング API を使用する必要があります。

永続化とオーディオファイル

--data ./studio-project.json を指定するか、MCP_AUDIO_STUDIO_DATA を設定すると、すべてのリビジョンが永続化されます。インポートしたオーディオは、プロジェクト内にデータ URL として保存されます。ブラウザーからインポートした音声とマイク録音は PCM WAV に正規化され、ブラウザーでの再生とオフラインレンダリングで同じアセットが使用されます。MCP から直接インポートする場合は、PCM／float WAV データを指定してください。オフラインレンダリングでは、常に 16 ビットステレオ WAV が出力されます。

最近のレンダリング結果はメモリー内に最大 8 件保持され、get_render、または Web モードでは GET /renders/:id で取得できます。

開発

npm ci
npm run typecheck
npm test
npm run build
npm run serve

npm run build を実行すると、React MCP App 全体を文字列として埋め込んだ単一の ./dist/index.js が生成されます。テストでは、公式 MCP SDK のリンクされたインメモリトランスポートを使用して、ツールと UI リソースの検出を検証します。

npm への公開

現在のバージョンを公開するには、次のコマンドを実行します。

npm run release

リリースコマンドは、必要に応じて npm にサインインし、チェック一式を実行してパッケージを一般公開した後、npm でそのバージョンが提供されていることを確認します。再実行しても問題ありません。同じバージョンがすでに公開されている場合は、プロジェクトを検証したうえで、重複する公開をスキップします。

公開せずにリリースヘルパーを検証するには、npm run release:check を実行します。

セキュリティ

• Web サーバーは識別につながるヘッダーを無効にし、埋め込みオーディオ用に 64 MB の JSON 制限を設定しています。
• MCP App はマイクとクリップボードへの書き込みの権限を要求しますが、ホストはどちらの機能も拒否できます。
• アプリはインライン、全画面、ピクチャーインピクチャー（pip）の表示モードに対応することを宣言しています。宣言されたモードのうちどれを利用可能にするかは、ホストが選択します。
• リモート WAM とオーディオの URL はプロジェクト状態に保持されますが、このリリースでは埋め込み MCP App の CSP によって使用が許可されていません。
• VST3 のパスはメタデータのみで、実行されることはありません。

脆弱性の報告については、SECURITY.md を参照してください。

ライセンス

MIT