██╗ ██╗███████╗ █████╗ ██╗ ██╗██████╗ ██╗ ██████╗ ███╗ ███╗ ██████╗██████╗
██║ ██║██╔════╝ ██╔══██╗██║ ██║██╔══██╗██║██╔═══██╗ ████╗ ████║██╔════╝██╔══██╗
██║ ██║█████╗ ███████║██║ ██║██║ ██║██║██║ ██║ ██╔████╔██║██║ ██████╔╝
██║ ██║██╔══╝ ██╔══██║██║ ██║██║ ██║██║██║ ██║ ██║╚██╔╝██║██║ ██╔═══╝
╚██████╔╝███████╗ ██║ ██║╚██████╔╝██████╔╝██║╚██████╔╝ ██║ ╚═╝ ██║╚██████╗██║
╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝
░░░░░░░░░░░░░░░░░░ AI Game Audio — Wwise + MetaSounds + Blueprints ░░░░░░░░░░░░░░░░░░░UE音频MCP
基于人工智能的游戏音频工具包——MetaSounds图形生成和导出、项目扫描以及通过MCP为虚幻引擎5.7创建的Wwise/Blueprint知识库。
一台MCP服务器。UE5插件，三个音频引擎，五个用于SID芯片仿真的自定义节点。74个工具。195个引擎验证的MetaSounds节点。针对虚幻引擎5.7和Wwise 2025进行了优化。
“为我的角色创建脚步声设置——在补丁中使用MetaSounds噪音和过滤器，在动画通知时触发蓝图” MCP生成MetaSounds DSP图（噪声->滤波器->AD包络），并输出动画触发器的蓝图接线。
______________________________________________________________________
建筑
Claude / Cursor / Any MCP Client
|
| MCP Protocol (stdio)
v
+---------------------------+
| UE Audio MCP |
| 74 tools |
| 1053 knowledge entries|
+---------------------------+
|
+-------------+-------------------+
v v v
+----------------+ +------------+ +------------------+
| Wwise Tools | | MetaSounds | | Blueprint Tools |
| (WAAPI) | | Tools | | (TCP + Knowledge)|
| 21 tools | | 24 tools | | 16 tools |
+-------+--------+ +-----+------+ +--------+---------+
| | |
v v v
+----------------+ +---------------------------+
| Wwise App | | UE5 C++ Plugin |
| WAAPI :8080 | | TCP:9877 (43 commands) |
+----------------+ | MetaSounds Builder API |
| Blueprint Graph Scanner |
| Editor Menu Integration |
+---------------------------+三层
| 层 | 引擎 | 角色 | 类比 |
|---|---|---|---|
| 蓝图 | UE5 | WHEN-检测游戏事件，设置参数 | 舞台管理器 |
| 元音 | UE5 | 什么——程序DSP，合成 | 仪器 |
| Wwise | 独立 | 如何——混合、巴士、空间化、交付 | 混合台 |
信号流
BLUEPRINT (WHEN) METASOUNDS (WHAT) WWISE (HOW)
---------------- ----------------- ------------
Player shoots -> Gunshot synthesis -> SFX bus, reverb
Player steps on grass -> Soft filtered step -> Distance attenuation
Weather changes to rain -> Layered rain + drops -> Ambient bus, RTPC mix
Vehicle accelerates -> Engine layer blend -> Vehicle bus, compression
C64 chiptune plays -> ReSID SID Chip node -> Music bus, stereo mix______________________________________________________________________
设置
# 1. MCP Server (Python)
git clone https://github.com/koshimazaki/UE-AUDIO-MCP.git
cd UE-AUDIO-MCP && pip install -e ".[dev]"
ue-audio-mcp// 2. MCP Client Config (Claude Code, Cursor, etc.)
{
"mcpServers": {
"ue-audio-mcp": { "command": "ue-audio-mcp", "transport": "stdio" }
}
}// 3. UE5 Plugin — copy to project Plugins/ folder, enable in plugin manager
ue5_plugin/UEAudioMCP/ → Editor module (TCP server, 43 commands)
ue5_plugin/SIDMetaSoundNodes/ → Runtime module (SID chip nodes)无需运行Wwise或UE5即可工作——知识库、模板和离线模式始终可用。
| 要求 | 版本 |
|---|---|
| 虚幻引擎 | 5.7.2+ （MetaSounds Builder API，自5.4起进行实验） |
| Wwise | 2025.1.4+ （启用WAAPI，本地主机上的WebSocket：8080） |
| Python | 3.10+ |
______________________________________________________________________
包含内容
- 74个MCP工具 --Wwise（21）、MetaSounds（24）、蓝图（16）、世界设置（7）、UE5核心（4）、编排（2）
- 1053条知识条目 --195个MetaSounds节点，347个别名，66个WAAPI函数，55个BP音频函数，TF-IDF搜索
- 73个模板 --33 MetaSounds DSP+34蓝图逻辑+6 Wwise层次结构（33/33 MS验证）
- 43个C++TCP命令 --MetaSounds Builder API、蓝图生成器、世界设置、图形扫描、资产查询
- 5个自定义C++节点 --ReSID SID芯片仿真器（振荡器、包络、滤波器、语音、全芯片）
- 11种音响系统模式 --枪声、脚步声、环境、车辆、天气、UI、SID合成器。..
- 编辑器菜单 --从UE5菜单栏扫描项目、导出MetaSounds、服务器状态
- 发动机同步 --842个MS节点+979个BP功能从实时UE5编辑器同步
来自已发货游戏的12个模板： 天琴座 （随机EQ、whizby、立体声平衡、游戏提示、动画通知音频）以及 StackOBot （阵列播放器、循环声音、EQ+延迟）。
看 工具_AND_COMMANDS.md 获取完整的工具列表、命令参考、声音设计器工作流程、模板目录和知识库详细信息。
______________________________________________________________________
ReSID SIDKIT版本——MetaSounds中的C64 SID芯片
5个定制的C++MetaSounds节点，封装了一个周期精确的MOS 6581/8580 SID芯片仿真器。在中运行的相同reSID核心 SIDKIT 项目，现在可以作为原生MetaSounds DSP节点使用。
| 节点 | 类型 | 描述 |
|---|---|---|
| SID振荡器 | 音频 | 24位累加器，8个波形（声/三波/脉冲/噪声+组合） |
| SID信封 | Float | 具有真实SID定时和延迟错误的非线性指数ADSR |
| SID筛选器 | 音频 | 通过6581的模拟滤波器传输任何音频--VICE VCR型号 |
| SID语音 | 音频 | 振荡器x信封便利组合 |
| SID芯片 | 音频 | 每个语音输出带滤波器、FM交叉调制的完整3语音SID |
SIDMetaSoundNodes 是一个单独的运行时模块，在没有MCP TCP服务器的游戏中提供。
______________________________________________________________________
代理技能
为Claude Code、Cursor、Windsurf和 35+其他代理商:
npx skills add koshimazaki/ue-audio-skills| 技能 | 它做什么 |
|---|---|
/mcp-plugin | TCP插件控制——用于构建MetaSounds图形、扫描蓝图、世界设置的43个命令 |
/metasound-dsp | MetaSounds DSP专家——195个节点，Builder API，信号流模式，图形模板 |
/unreal-bp | 蓝图音频逻辑——游戏事件检测、参数连接、资产扫描 |
/build-system | 全流水线编排器——从单个描述生成完整的3层音频系统 |
______________________________________________________________________
现有技术
| 现有工具 | 音频？ |
|---|---|
| 搅拌机mcp （16.9k星）--控制搅拌机 | 否 |
| 虚幻的mcp （1370颗星）--控制UE5编辑器 | 否 |
| VibeComfy MCP --8400+个ComfyUI节点 | 否 |
| BilkentAudio/Wwise MCP --Wwise包装 | 部分 |
| 这个项目 --完整的三层游戏音频+SID芯片仿真 | 是 |
______________________________________________________________________
学分
所有模板和知识均来自公共资源：Epic Games文档和教程、Audiokinetic SDK参考和社区教程。基于ReSID仿真 残差 由Dag Lem设计，带有SIDKIT扩展名。
看 CREDITS.md 以完全归因于教程作者和数据源。
主要来源： 柯瑞格·欧文 （雅格）， 马特·斯彭德洛夫, 尼克 Pfisterer, 埃里克·布赫兹 （TechAudioTools）， 克里斯·潘恩，Epic Games官方文件。
______________________________________________________________________
作者
由...建造 Koshi Mazaki
______________________________________________________________________
许可证
麻省理工学院