Wwise MCP Server

GWwise — Wwise MCP 服务

将 AI 助手连接到 Audiokinetic Wwise，用于游戏音频批量编辑、项目检查、性能分析和试听。 GWwise 是一个基于 Wwise Authoring API（WAAPI）的本地模型上下文协议（MCP）服务。

English · 简体中文 · 下载 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_ 开头。这些是接口数量，并非基准测试，也不表示每种工作流都只需调用一次。

为什么考虑使用 GWwise？

需求	本项目的实现方式	限制
简单的 Windows 部署	官方发布版本提供单个可执行文件；用户无需 Python 或 Node.js 即可运行	仍需安装支持 WAAPI 的 Wwise Authoring；请从可信发布渠道获取二进制文件
重复的 Authoring 工作	提供用于替换音源、同步层级、重命名和路由的专用工具	某些操作可能部分成功；请检查每项返回结果
支持版本感知的请求	根据所连接的 Wwise 实例动态发现函数、主题和架构	发现结果并不能证明与每个版本兼容；请参阅版本证据
减少手动编写 API 负载	高级工具可与原始 WAAPI 和 WAQL 访问方式共存	原始调用可能修改或删除内容；没有通用的只读强制模式
为 Agent 提供操作指南	官方二进制文件包含维护者调优过的知识库	公开源码构建使用备用指令；源码和知识库的许可不同

快速开始：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，并报告已连接应用程序的版本和项目信息。查询选中的对象并列出可用架构。不要更改项目对象、保存项目、生成 SoundBanks、删除文件、开始播放或更改 Profiler 会话。

这是给助手的指令，并非由服务端强制执行的权限边界。支持工具允许列表的客户端应首先只开放所需的检查工具。

实用工作流

这些是可复现的工作流指南，并不表示这些场景在本次文档更新期间已成功运行。

任务	指南	可用的起始工具
替换同名 WAV 源，同时保留现有 Sound 层级	替换音频源而不创建新的 Sounds	waapi_query、list_local_audio_files、batch_replace_audio_by_name
检查对象属性、路由、引用和 SoundBank 包含情况	检查并审计 Wwise 项目	waapi_query、waapi_get_schema、get_soundbank_inclusions
采样运行时状态并预览 Event	Profiler 采样与受控试听	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	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 不提供相同的预览保障。
• 撤销组不等于事务。 批处理可能报告单项失败，或留下部分变更。后续路由操作可能使用另一个撤销组。不要承诺一次 Ctrl+Z 就能撤销整个工作流。
• 磁盘变更另有风险。 cleanup_unused_originals_files 可能永久删除文件；Wwise 撤销无法恢复这些文件。预览也可能写入报告。请勿在常规检查中启用清理。
• Profiler 捕获和试听会影响会话。 采样可能会启用 Profiler 数据，播放工具会产生可听见的声音。执行其中任一操作前都要获得许可，并确认最终状态。
• 默认端点是本地端点，并非授权沙箱。 主机参数和连接工具可以选择其他端点。请在可信网络中使用 WAAPI。AI 客户端有自己的数据和隐私政策。
• 发现架构不保证编辑正确或声音效果符合预期。 仍需测试 Wwise 版本、结构、语言、插件和客户端行为。

兼容性与证据

维护者此前报告称，该项目已在 Wwise 2019–2025 中使用；仓库描述另行提到了 2021 和 2024。此检出版本尚未发布针对确切构建版本的证据，因此这里不将其列为经过验证的逐版本支持矩阵。如何记录运行情况，请参阅兼容性。

源代码包含 175 个测试用例，涵盖单元测试、定义契约、知识文本路由契约、协议和实时 Wwise 测试套件。这不代表有 175 个实时 Wwise 测试：实时测试函数有九个，且如果缺少 Wwise 或私有知识库，部分测试会提前返回。汇总结果全绿并不能证明已覆盖端到端测试。请参阅验证与复现。

从源代码构建

安装 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 版本、操作系统、任务以及脱敏后的错误信息。未经许可，请勿发布私人项目路径、凭据或受版权保护的音频。