Wwise MCP Server

GWwise — Wwise MCP サーバー

AI アシスタントを Audiokinetic Wwise に接続し、ゲームオーディオの一括編集、プロジェクトの調査、プロファイリング、試聴を行えます。 GWwise は、Wwise Authoring API（WAAPI）を基盤とするローカルの Model Context Protocol（MCP）サーバーです。

英語 · 簡体字中国語 · Windows 実行ファイルをダウンロード · ワークフロー · 互換性 · 検証

正式なプロジェクト: WilliamWAudio/wwise-mcp-server。リポジトリ名は wwise-mcp-server、実行ファイルおよび MCP サーバー名は gwwise-mcp-server、略称は GWwise です。これは独立したコミュニティプロジェクトであり、Audiokinetic の製品ではありません。

何に使えますか？

• 名前で Wwise オーディオソースを置き換えます。意図的に新しい Sound オブジェクトを作成することはありません。
• オブジェクトの一括名称変更や整理、不足している子孫オブジェクトのコピーまたは移動、相対パスによる Output Bus 参照の同期を行います。
• WAQL を使用してプロジェクトを調査し、プロパティや参照を読み取り、接続先の Wwise インスタンスが実際に備える API スキーマを確認します。
• Wwise Authoring を通じて SoundBank を生成し、Profiler データをサンプリングし、オーディオを試聴します。
• 同じ状態を繰り返し問い合わせる代わりに、WAAPI イベントを購読します。

公開カタログには 45 個の MCP ツールがあります。内訳は、knowledge/defs.json の 44 個の定義と、サーバーが追加する wwise_connect です。このうち、17 個の名前は batch_ で始まります。これらはインターフェースの数であり、ベンチマークでも、すべてのワークフローが 1 回の呼び出しで済むという主張でもありません。

GWwise を検討する理由

ニーズ	このプロジェクトのアプローチ	制限事項
Windows への簡単な導入	公式リリースでは実行ファイル 1 つを提供しており、実行に Python や Node.js は不要です	WAAPI を備えた Wwise Authoring は引き続き必要です。信頼できるリリースからバイナリを入手してください
繰り返し発生するオーサリング作業	ソースの置換、階層の同期、名称変更、ルーティングに特化したツールを提供します	一部の操作では部分的に成功する場合があります。返された結果を個別に確認してください
バージョンに応じたリクエスト	接続先の Wwise インスタンスから関数、トピック、スキーマを動的に検出します	検出によってすべてのリリースとの互換性が証明されるわけではありません。バージョンの根拠を参照してください
手動での API ペイロード作成を減らす	高水準のツールに加え、生の WAAPI および WAQL へのアクセスも利用できます	生の呼び出しではコンテンツを変更または削除できます。あらゆる操作に適用される読み取り専用モードはありません
エージェント向けの操作ガイダンス	公式バイナリには、メンテナーが調整したナレッジベースが含まれます	公開ソースからのビルドではフォールバック手順を使用します。ソースとナレッジのライセンスは異なります

クイックスタート：Windows 実行ファイル

1. GitHub Releases から gwwise-mcp-server.exe をダウンロードします。これは ローカルの stdio サーバーであり、クラウド URL にデプロイするホスト型サービスではありません。
2. バックアップしたテスト用コピーの Wwise プロジェクトを開きます。
3. Project → User Preferences → Wwise Authoring API を有効にします。WAMP ポートを確認してください。通常のデフォルト値は 8080 です。
4. 実行ファイルを MCP 対応クライアントに登録します。例にある絶対パスを実際のパスに置き換えてください。

Claude Desktop / Claude Code の設定例（claude_desktop_config.json / .mcp.json）：

{
  "mcpServers": {
    "wwise": {
      "command": "C:/Tools/GWwise/gwwise-mcp-server.exe",
      "args": ["--wwise-host", "127.0.0.1", "--wwise-port", "8080"]
    }
  }
}

Cursor の例（.cursor/mcp.json）：

{
  "mcpServers": {
    "wwise": {
      "command": "C:/Tools/GWwise/gwwise-mcp-server.exe",
      "args": ["--wwise-port", "8080"]
    }
  }
}

Codex の設定例（config.toml）：

[mcp_servers.wwise]
command = "C:/Tools/GWwise/gwwise-mcp-server.exe"
args = ["--wwise-host", "127.0.0.1", "--wwise-port", "8080"]

クライアントの設定場所と承認機能は、クライアントのバージョンによって異なります。Wwise が起動する前にサーバーを起動でき、ツールが WAAPI を必要とした時点で接続します。接続コードは近隣の代替ポートを試す場合があります。編集を行う前に、返されたプロジェクトとエンドポイントを必ず確認してください。特に、複数の Wwise インスタンスが開いている場合は注意が必要です。

最初のリクエスト：調査のみ。編集しないでください

Wwise に接続し、接続されているアプリケーションのバージョンとプロジェクトの識別情報を報告してください。選択されているオブジェクトを照会し、利用可能なスキーマを一覧表示してください。プロジェクトのオブジェクトを変更したり、プロジェクトを保存したり、SoundBank を生成したり、ファイルを削除したり、再生を開始したり、プロファイラーのセッションを変更したりしないでください。

これはアシスタントへの指示であり、サーバーによって強制される権限境界ではありません。ツールの許可リストに対応するクライアントでは、まず必要な調査ツールのみを公開してください。

実践的なワークフロー

これらは再現可能なワークフローガイドであり、今回のドキュメント更新中にシナリオが正常に実行されたことを示すものではありません。

タスク	ガイド	便利な開始ツール
既存の Sound 階層を維持しながら、同名の WAV ソースを置き換える	新しい Sound を作成せずにオーディオソースを置き換える	waapi_query、list_local_audio_files、batch_replace_audio_by_name
オブジェクトのプロパティ、ルーティング、参照、SoundBank への包含を確認する	Wwise プロジェクトを調査して監査する	waapi_query、waapi_get_schema、get_soundbank_inclusions
実行時の状態をサンプリングし、Event をプレビューする	プロファイラーのサンプリングと制御された試聴	profiler_capture、transport_play、transport_control

リクエストの例：

• 「Weapons 配下にある、ボリュームが -10 dB 未満の Sound をすべて一覧表示してください。GUID とパスを報告し、何も変更しないでください。」
• 「選択したサブツリーを、これらの同名 WAV ファイルと比較してください。まず一致候補を表示し、私が確認するまでオーディオを置き換えないでください。」
• 「このソースからこのターゲットへ、不足している子孫を移動する操作をプレビューしてください。ツールが対応している場合は、preview_only: true を明示してください。」
• 「オブジェクト名の変更をサブスクライブし、イベントを待ってから、完了時にサブスクライブを解除してください。」

ツールカタログ

ドメイン	ツール
コア	waapi_call、waapi_query、wwise_connect
ローカルファイル	list_local_audio_files、create_path_if_not_exists、get_project_languages
一括名称変更	batch_rename_lowercase、batch_rename_titlecase、batch_rename_uppercase、batch_rename_find_replace、batch_rename_add_prefix、batch_rename_add_suffix
一括構造操作	batch_delete、batch_smart_delete、batch_delete_unused_descendants、batch_convert_type、batch_set_property、batch_move、batch_get_children_by_type
構造の同期	batch_copy_missing_descendants、batch_move_missing_descendants、batch_sync_output_bus_by_relative_path
オーディオソース	batch_replace_audio_by_name、cleanup_unused_originals_files
イントロスペクション	waapi_list_functions、waapi_list_topics、waapi_get_schema
SoundBank	generate_soundbanks、get_soundbank_inclusions
プロファイラー	profiler_capture
リモート接続	remote_list_consoles、remote_connect、remote_disconnect
Wwise UI	ui_get_selection、ui_list_commands、ui_execute_command
サブスクリプション	waapi_subscribe、waapi_poll_events、waapi_wait_for_event、waapi_list_subscriptions、waapi_unsubscribe
ヘルス／試聴	wwise_get_info、transport_play、transport_control、transport_list

権威あるパラメーター定義は knowledge/defs.json と src/bin/mcp_server.rs にあります。名前が似たツールのオプションが同じだと決めつけず、スキーマを確認してください。

安全性と制限事項

• 書き込みを行う前に、プロジェクトと Originals をバックアップしてください。 まず、対象のプロジェクト、GUID、対象範囲、変更内容を照会して確認してください。
• プレビューの仕様はツールごとに異なります。 対応している場合は、preview_only を明示的に設定してください。batch_replace_audio_by_name と生の batch_delete は、同じプレビュー仕様を提供しません。
• Undo グループはトランザクションではありません。 バッチ処理では、項目ごとの失敗が報告されたり、変更が一部だけ反映されたりする場合があります。後続のルーティング作業では、別の Undo グループが使われることがあります。すべてのワークフローを Ctrl+Z 1回で元に戻せると約束しないでください。
• ディスク上の変更には別のリスクがあります。 cleanup_unused_originals_files はファイルを完全に削除する可能性があり、Wwise の Undo では復元できません。プレビューでもレポートが書き込まれる場合があります。通常の調査ではクリーンアップを有効にしないでください。
• プロファイラーのキャプチャと試聴はセッションに影響します。 サンプリングによってプロファイラーのデータ収集が有効になる場合があり、再生ツールからは音が出ます。どちらも実行前に許可を得て、最終状態を確認してください。
• デフォルトのエンドポイントはローカルですが、認可を制限するサンドボックスではありません。 ホスト引数や接続ツールを使って、別のエンドポイントを選択できます。WAAPI は信頼できるネットワーク上で使用してください。AI クライアントには独自のデータおよびプライバシーポリシーがあります。
• スキーマを調べても、編集や音の結果が正しいとは限りません。 Wwise のバージョン、構造、言語、プラグイン、クライアントの動作について、引き続きテストが必要です。

互換性とエビデンス

メンテナーは以前、Wwise 2019～2025 での使用を報告していましたが、リポジトリの説明では別途 2021 と 2024 に言及していました。このチェックアウトでは、正確なビルドに関するエビデンスはまだ公開されていません。そのため、これらを検証済みのバージョン別サポートマトリックスとして提示していません。実行結果の記録方法については、互換性を参照してください。

ソースには、ユニット、定義コントラクト、ナレッジテキストのルーティングコントラクト、プロトコル、ライブ Wwise の各テストスイートに、175 件のテストケースが含まれています。これは、ライブ Wwise テストが175件あるという意味ではありません。ライブテスト関数は9つで、Wwise またはプライベートナレッジベースが存在しない場合に早期リターンするテストもあります。集計結果がすべて成功しても、E2E カバレッジの証明にはなりません。検証と再現を参照してください。

ソースからビルドする

Rust ツールチェーンとプラットフォーム固有のネイティブビルド前提条件をインストールし、次を実行してください。

cargo build --release

Windows の実行ファイルは target/release/gwwise-mcp-server.exe です。ソースからビルドした場合も、公開されているツール定義は同じですが、knowledge/base.txt は意図的に含まれていないため、フォールバック指示が使用されます。このコマンドから、Windows 以外のサポートや Rust の最小バージョンを推測しないでください。詳しくは互換性を参照してください。

コントリビューター向けのドキュメントとメタデータのチェック（このチェックにのみ Node.js が必要で、GWwise の実行には不要です）：

node scripts/check-docs.mjs

配布とディレクトリ掲載

• Windows EXE リリースは、引き続き直接インストールする方法です。
• MCPB のパッケージ化と Registry の準備では、任意で利用できるバンドルについて説明しています。生の .exe は MCPB パッケージではありません。これらのファイルは、新たな Registry への公開を主張するものではありません。
• glama.json は、ディレクトリのメタデータ用にメンテナーを示すものです。所有権の検証やディレクトリの審査が完了したと主張するものではありません。
• メンテナー向けディレクトリ掲載チェックリストでは、リポジトリの About とトピック、ディレクトリ情報の修正、公開エビデンス、実際のコミュニティ事例を取り上げています。

ライセンスとプロジェクトの所有権

• 公開ソースコード、ツール定義、公開ドキュメント：MIT。 標準のルート LICENSE を参照してください。
• 調整済みナレッジベース（knowledge/base.txt）および公式バイナリに埋め込まれたそのコンテンツ：プロプライエタリ。 元の無料での個人利用・商用利用の条件と制限は、knowledge/LICENSE に記載されています。公式バイナリ全体がMITライセンスであるとは説明しないでください。
• GWwiseにはWwiseは含まれておらず、Wwise、サードパーティ製プラグイン、またはお客様のオーディオアセットに対する権利も付与されません。

メンテナー：WilliamWAudio / william.wang。再現可能な問題はGitHub Issuesに報告してください。その際、GWwiseのバージョン、正確なWwiseビルド、オペレーティングシステム、タスク、個人情報などを伏せたエラー内容を含めてください。許可なく、非公開のプロジェクトパス、認証情報、著作権で保護されたオーディオを投稿しないでください。