██╗ ██╗███████╗ █████╗ ██╗ ██╗██████╗ ██╗ ██████╗ ███╗ ███╗ ██████╗██████╗
██║ ██║██╔════╝ ██╔══██╗██║ ██║██╔══██╗██║██╔═══██╗ ████╗ ████║██╔════╝██╔══██╗
██║ ██║█████╗ ███████║██║ ██║██║ ██║██║██║ ██║ ██╔████╔██║██║ ██████╔╝
██║ ██║██╔══╝ ██╔══██║██║ ██║██║ ██║██║██║ ██║ ██║╚██╔╝██║██║ ██╔═══╝
╚██████╔╝███████╗ ██║ ██║╚██████╔╝██████╔╝██║╚██████╔╝ ██║ ╚═╝ ██║╚██████╗██║
╚═════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝╚═╝
░░░░░░░░░░░░░░░░░░ AI Game Audio — Wwise + MetaSounds + Blueprints ░░░░░░░░░░░░░░░░░░░UE Audio MCP
AI-powered game audio toolkit — MetaSounds graph generation & export, project scanning, and Wwise/Blueprint knowledge base via MCP for Unreal Engine 5.7.
One MCP server. UE5 Plugin, three audio engines, five custom nodes for SID chip emulation. 81 tools. 195 engine-verified MetaSounds nodes. Optimised for Unreal Engine 5.7 and Wwise 2025.
"Create a footsteps sound setup for my character -- use MetaSounds noise and filter in the patch, Blueprint trigger on anim notify" MCP generates the MetaSounds DSP graph (noise -> filter -> AD envelope) and outputs Blueprint wiring for the animation trigger.
---
Architecture
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 |
+---------------------------+The Three Layers
| Layer | Engine | Role | Analogy | |-------|--------|------|---------| | Blueprint | UE5 | WHEN -- detects game events, sets parameters | Stage manager | | MetaSounds | UE5 | WHAT -- procedural DSP, synthesis | The instrument | | Wwise | Standalone | HOW -- mixing, buses, spatialization, delivery | The mixing desk |
Signal Flow
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---
Setup
# 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)Works without Wwise or UE5 running -- knowledge base, templates, and offline mode always available.
| Requirement | Version | |-------------|---------| | Unreal Engine | 5.7.2+ (MetaSounds Builder API, experimental since 5.4) | | Wwise | 2025.1.4+ (WAAPI enabled, WebSocket on localhost:8080) | | Python | 3.10+ |
---
What's Included
- 81 MCP tools -- Wwise (21), MetaSounds (24), Blueprint (16), World Setup (7), Actor/Camera (5), UE5 Core (4), orchestration (2), audit (2)
- 1042 seeded catalogue rows -- 195 MetaSounds nodes, 356 aliases, 66 WAAPI functions, 55 BP audio functions, 130 pin mappings, 26 engine plugin assets
- 73 templates -- 33 MetaSounds DSP + 34 Blueprint logic + 6 Wwise hierarchy (33/33 MS validated)
- 48 C++ TCP commands -- MetaSounds Builder API, Blueprint builder, world setup, actor/camera staging, graph scanning, asset queries
- 5 custom C++ nodes -- ReSID SID chip emulator (oscillator, envelope, filter, voice, full chip)
- 11 audio system patterns -- gunshot, footsteps, ambient, vehicle, weather, UI, SID synth...
- Editor menu -- Scan Project, Export MetaSounds, Server Status from UE5 menu bar
- Engine sync snapshots -- 897 MS nodes + 1173 audio BP functions exported from live UE5 editor
12 templates from shipped games: Lyra (random EQ, whizby, stereo balance, gameplay cues, anim notify audio) and StackOBot (array player, looped sound, EQ+delay).
See TOOLS_AND_COMMANDS.md for full tool listing, command reference, sound designer workflows, template catalogue, and knowledge base details. Run python scripts/db_inventory.py to reconcile source catalogue, SQLite, and engine export counts.
---
ReSID SIDKIT Edition -- C64 SID Chip in MetaSounds
5 custom C++ MetaSounds nodes wrapping a cycle-accurate MOS 6581/8580 SID chip emulator. The same reSID core running in the SIDKIT project, now available as native MetaSounds DSP nodes.
| Node | Type | Description | |------|------|-------------| | SID Oscillator | Audio | 24-bit accumulator, 8 waveforms (saw/tri/pulse/noise + combined) | | SID Envelope | Float | Non-linear exponential ADSR with authentic SID timing and delay bug | | SID Filter | Audio | Route any audio through the 6581's analog filter -- VICE VCR model | | SID Voice | Audio | Oscillator x Envelope convenience combo | | SID Chip | Audio | Complete 3-voice SID with filter, FM cross-modulation, per-voice outputs |
SIDMetaSoundNodes is a separate Runtime module -- ships in games without the MCP TCP server.
---
Agent Skills
Install UE Audio agent skills for Claude Code, Cursor, Windsurf, and 35+ other agents:
npx skills add koshimazaki/ue-audio-skills| Skill | What it does | |-------|-------------| | /mcp-plugin | TCP plugin control -- 48 commands for building MetaSounds graphs, scanning blueprints, world setup, actor/camera staging | | /metasound-dsp | MetaSounds DSP specialist -- 195 nodes, Builder API, signal flow patterns, graph templates | | /unreal-bp | Blueprint audio logic -- game event detection, parameter wiring, asset scanning | | /build-system | Full pipeline orchestrator -- generates complete 3-layer audio systems from a single description |
---
Prior Art
| Existing Tool | Audio? | |---|---| | blender-mcp (16.9k stars) -- Controls Blender | No | | unreal-mcp (1,370 stars) -- Controls UE5 editor | No | | VibeComfy MCP -- 8,400+ ComfyUI nodes | No | | BilkentAudio/Wwise-MCP -- Wwise wrapper | Partial | | This project -- Complete 3-layer game audio + SID chip emulation | Yes |
---
Credits
All templates and knowledge curated from public sources: Epic Games documentation, and tutorials, Audiokinetic SDK reference, and community tutorials. ReSID emulation based on reSID by Dag Lem with SIDKIT extensions.
See CREDITS.md for full attribution to tutorial authors and data sources.
Key sources: Craig Owen (YAGER), Matt Spendlove, Nick Pfisterer, Eric Buchholz (TechAudioTools), Chris Payne, Epic Games official documentation.
---
Author
Built by Koshi Mazaki
---
Licence
MIT
