AI导哈

游戏音频工具包

AI驱动的游戏音频工具包，支持MetaSounds图形生成与导出、项目扫描，以及通过MCP为Unreal Engine 5.7提供的Wwise/Blueprint知识库。

  • by koshimazaki
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 koshimazaki/UE-AUDIO-MCP

使用说明

██╗   ██╗███████╗     █████╗ ██╗   ██╗██████╗ ██╗ ██████╗     ███╗   ███╗ ██████╗██████╗
██║   ██║██╔════╝    ██╔══██╗██║   ██║██╔══██╗██║██╔═══██╗    ████╗ ████║██╔════╝██╔══██╗
██║   ██║█████╗      ███████║██║   ██║██║  ██║██║██║   ██║    ██╔████╔██║██║     ██████╔╝
██║   ██║██╔══╝      ██╔══██║██║   ██║██║  ██║██║██║   ██║    ██║╚██╔╝██║██║     ██╔═══╝
╚██████╔╝███████╗    ██║  ██║╚██████╔╝██████╔╝██║╚██████╔╝    ██║ ╚═╝ ██║╚██████╗██║
 ╚═════╝ ╚══════╝    ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝     ╚═╝     ╚═╝ ╚═════╝╚═╝
░░░░░░░░░░░░░░░░░░ AI Game Audio — Wwise + MetaSounds + Blueprints ░░░░░░░░░░░░░░░░░░░

UE音频MCP

基于人工智能的游戏音频工具包——MetaSounds图形生成和导出、项目扫描以及通过MCP为虚幻引擎5.7创建的Wwise/Blueprint知识库。

一台MCP服务器。UE5插件，三个音频引擎，五个用于SID芯片仿真的自定义节点。81个工具。195个引擎验证的MetaSounds节点。针对虚幻引擎5.7和Wwise 2025进行了优化。

“为我的角色创建脚步声设置——在补丁中使用MetaSounds噪音和过滤器，在动画通知时触发蓝图”

MCP生成MetaSounds DSP图（噪声->滤波器->AD包络），并输出动画触发器的蓝图接线。

建筑

                    Claude / Cursor / Any MCP Client
                                |
                                | MCP Protocol (stdio)
                                v
                    +---------------------------+
                    |      UE Audio MCP         |
                    |      81 tools             |
                    |      1042 catalogue rows   |
                    +---------------------------+
                            |
              +-------------+-------------------+
              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 (48 commands)     |
     +----------------+ | MetaSounds Builder API     |
                        | Blueprint Graph Scanner    |
                        | Editor Menu Integration    |
                        +---------------------------+

三层

层 引擎 角色 类比
蓝图 UE5 WHEN-检测游戏事件，设置参数 舞台管理器
MetaSounds UE5 什么——程序DSP，合成 仪器
频谱效率 独立 如何——混合、巴士、空间化、交付 混合台

信号流

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, 48 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+

包含内容

  • 81个MCP工具 --Wwise（21）、MetaSounds（24）、蓝图（16）、世界设置（7）、演员/摄像机（5）、UE5核心（4）、编排（2）、审计（2）
  • 1042个种子目录行 --195个MetaSounds节点，356个别名，66个WAAPI函数，55个BP音频函数，130个引脚映射，26个引擎插件资源
  • 73个模板 --33 MetaSounds DSP+34蓝图逻辑+6 Wwise层次结构（33/33 MS验证）
  • 48个C++TCP命令 --MetaSounds Builder API、蓝图生成器、世界设置、演员/摄像机舞台、图形扫描、资产查询
  • 5个自定义C++节点 --ReSID SID芯片仿真器（振荡器、包络、滤波器、语音、全芯片）
  • 11种音响系统模式 --枪声、脚步声、环境、车辆、天气、UI、SID合成器。..
  • 编辑器菜单 --从UE5菜单栏扫描项目、导出MetaSounds、服务器状态
  • 引擎同步快照 --897个MS节点+1173个从UE5实时编辑器导出的音频BP函数

来自已发货游戏的12个模板： 天琴座 （随机EQ、whizby、立体声平衡、游戏提示、动画通知音频）以及 StackOBot （阵列播放器、循环声音、EQ+延迟）。

看 工具_AND_COMMANDS.md 获取完整的工具列表、命令参考、声音设计器工作流程、模板目录和知识库详细信息。跑 python scripts/db_inventory.py 协调源目录、SQLite和引擎导出计数。

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图形、扫描蓝图、世界设置、演员/摄像机登台的48个命令
/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

许可证

麻省理工学院

相关 MCP