The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Wwise MCP Server listing page.
Official repository / 官方仓库: https://github.com/WilliamWAudio/wwise-mcp-server — releases, issues, and updates all live here.
A Model Context Protocol (MCP) server for Audiokinetic Wwise — 45 tools covering raw WAAPI calls, WAQL queries, 20 batch super-interfaces, dynamic API introspection, real-time event subscriptions, SoundBank generation, profiler capture, remote game connection, UI automation, and audio audition. Works with Claude (Desktop / Code), Cursor, Codex, and any MCP client.
Single self-contained executable. No Python, no Node.js, no virtual environments, no dependencies — download one file and go. The full Wwise knowledge base ships inside the binary and is served to your AI client automatically.
| wwise-mcp-server (this project) | Typical Wwise MCP | |
|---|---|---|
| Tools | 45 across 11 domains | 5–15, mostly raw WAAPI passthrough |
| Batch super-interfaces | 20 (atomic, single-undo, e.g. replace audio sources by name without creating new Sounds) | none |
| Wwise version compatibility | Dynamic introspection — queries the connected Wwise for its real schemas; verified on Wwise 2019 – 2025 | hardcoded parameters that break across versions |
| Event subscriptions | Full WAMP subscribe/poll/wait, auto-resubscribe on reconnect, ~15 ms delivery | none |
| Context efficiency | ~8K tokens for all 45 schemas + automatic truncation of oversized results | unbounded result dumps |
| Quality assurance | 175 automated tests (unit + contract + protocol + live E2E against a running Wwise) | usually zero |
| Setup | Download 1 exe | Python 3.13 + venv + pip, or Node.js |
Grab gwwise-mcp-server.exe from the latest Release.
Or build from source (Rust 1.75+): cargo build --release. Source builds are fully functional (all 45 tools); official release binaries additionally embed the tuned knowledge base — see Open core.
Wwise → Project > User Preferences → Enable Wwise Authoring API (default port 8080).
Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):
Cursor (.cursor/mcp.json):
Codex CLI (~/.codex/config.toml):
The server starts even if Wwise is not running — it connects automatically on the first tool call.
| Domain | Tools |
|---|---|
| Core | waapi_call (any WAAPI URI), waapi_query (WAQL), wwise_connect |
| Local files | list_local_audio_files, create_path_if_not_exists, get_project_languages |
| Batch rename | lowercase / titlecase / uppercase / find-replace / prefix / suffix |
| Batch structure | batch_delete, batch_smart_delete (reference preflight + preview), batch_delete_unused_descendants, batch_convert_type, batch_set_property, batch_move, batch_get_children_by_type |
| Structure sync | batch_copy_missing_descendants, batch_move_missing_descendants, batch_sync_output_bus_by_relative_path |
| Audio sources | batch_replace_audio_by_name (strict in-place replacement — never creates new Sounds), cleanup_unused_originals_files |
| Introspection | waapi_list_functions, waapi_list_topics, waapi_get_schema |
| SoundBank | generate_soundbanks, get_soundbank_inclusions |
| Profiler | profiler_capture (one-call sampling session) |
| Remote | remote_list_consoles, remote_connect, remote_disconnect |
| UI automation | ui_get_selection, ui_list_commands, ui_execute_command |
| Subscriptions | waapi_subscribe, waapi_poll_events, waapi_wait_for_event, waapi_list_subscriptions, waapi_unsubscribe |
| Health / audition | wwise_get_info, transport_play, transport_control, transport_list |
All batch operations are atomic: one undo step in Wwise (Ctrl+Z reverts everything).
Every release passes 175 automated tests: unit, tool-definition contract, natural-language routing, MCP protocol compliance (spawning the real binary over stdio), and live end-to-end tests against running Wwise instances.
Verified on Wwise 2019 – 2025, with full end-to-end coverage (real event delivery, audition transport lifecycle, profiler capture) across many Wwise versions from 2019 to 2025. Dynamic WAAPI introspection keeps it working across Wwise versions without updates.
instructions. This is why the official binary gives a noticeably smarter experience than a bare source build.Source code: MIT. Embedded knowledge base: proprietary, free to use via official binaries. See LICENSE.
© 2025-2026 william.wang