BilkentAudio/Wwise-MCP

Wwise-MCP는 대규모 언어 모델 (LLMs)이 Wwise Authoring 애플리케이션과 상호작용할 수 있도록 지원하는 Model Context Protocol (MCP) 서버입니다. 이 서버는 커스텀 Python WAAPI 라이브러리를 기반으로 구축된 도구 세트를 제공하여, Claude 또는 Cursor와 같은 MCP 클라이언트가 복잡하고 다단계인 Wwise 워크플로 (workflows)를 자동화하고 구성할 수 있도록 합니다.

이 프로젝트는 현재 실험적 (EXPERIMENTAL) 단계에 있습니다.
현재 활발히 개발 중이며, 현재로서는 실제 제작 (production)용 Wwise 프로젝트에 사용해서는 안 됩니다. 다음 사항을 유의해 주세요:

• 예고 없이 중대한 변경 사항 (Breaking changes)이 발생할 수 있습니다.

• 기능이 불완전하거나 불안정할 수 있습니다.

• 문서가 오래되었거나 누락되었을 수 있습니다.

• 현재 시점에서는 실제 제작 (Production) 용도 사용을 권장하지 않습니다.

• Claude Desktop, Cursor 또는 기타 MCP 호환 AI 플랫폼을 설치하세요.

• Wwise 2024.1 이상 버전을 설치하세요.

• 최신 Wwise-MCP.zip을 설치하세요.

• 위의 3가지 구성 요소를 설치했다면, MCP 클라이언트(예: Claude 또는 Cursor)의 json 파일을 구성하여 Wwise-MCP 애플리케이션을 포함시키세요.

{
"mcpServers":
{
...

GithubWwiseMCPTutorial.mp4

• Claude 및 Cursor에서의 설정에 대한 자세한 지침은 설정 페이지를 참조하세요.

• macOS의 경우, 설정 후 Wwise-MCP를 처음 실행할 때 macOS 보안 문제로 인해 오류가 발생할 가능성이 높습니다.

• 이를 우회하려면, **Terminal (터미널)**을 열고 다음 명령어를 실행하세요: chmod +x "/YourPathTo/Wwise-MCP-v1-0/macOS/Apple Silicon/Wwise-MCP"

• 위 명령어를 본인이 저장한 Wwise-MCP의 버전 (Intel 또는 Silicon) 경로에 맞게 설정했는지 확인하세요. 그 후 MCP 클라이언트(예: Claude)를 다시 실행하세요. 다시 실패할 수도 있습니다. **System Settings (시스템 설정)**의 Privacy & Security (개인정보 보호 및 보안) 섹션으로 이동하면, `

“Resolve parent path (부모 경로 해결)” 명령을 사용하세요.

이 명령은 주어진 Wwise 경로 아래의 객체 인덱스(index)를 구축하여, Claude가 경로를 통해 프로젝트를 캐싱(cache)하고 탐색할 수 있도록 합니다. 시작하기 좋은 위치는 Wwise의 최상위 루트 중 하나입니다. 예를 들어 다음과 같습니다:
\Actor-Mixer Hierarchy
\Containers (Wwise 2025)
\Events
\Switches
\States
\Game Parameters

프롬프트 예시:
Resolve all path relationships in actor mixer. (액터 믹서의 모든 경로 관계를 해결해줘.)

게임 객체(game object) 관련 프롬프트(예: “5개의 새로운 게임 객체에 X 이벤트를 Post하고 원점으로부터 500 유닛 범위에 분산시켜줘”)를 사용하기 전에, Wwise의 Game Object 뷰에서 **“Start Capture (캡처 시작)”**가 활성화되었는지(활성화 시 빨간색) 반드시 확인하세요.

Wwise Session Connection (Wwise 세션 연결): 에이전트가 적절한 Wwise 세션에 WAAPI 명령을 내릴 수 있도록 활성화된 Wwise 세션에 연결합니다.
Hierarchy Indexing (계층 구조 인덱싱): 부모 경로를 스캔하여 빠른 조회 및 탐색을 위해 하위 트리의 경로 우선 인덱스를 구축합니다.
Object Creation & Organization (객체 생성 및 정리): 지정된 부모 경로 아래에 Actor-Mixer, Container, Bus, Work Unit, Soundbank, Folder 등을 생성하며, 이를 일괄적으로 이동하거나 이름을 변경할 수 있습니다.
Event Authoring (이벤트 저작): 소스 객체와 부모 경로를 기반으로 여러 Wwise 이벤트를 한 번에 생성하며, 기존의 모든 이벤트 이름을 나열합니다.
Game Object Management (게임 객체 관리): 게임 객체를 일괄적으로 생성, 이동 및 등록 해제(unregister)하며, 완전한 3D 포지셔닝(positioning) 지원 및 글로벌 폴백(fallback) 객체를 제공합니다.
RTPC / Switch / State Setup (RTPC / Switch / State 설정): RTPC, Switch Group, Switch, State Group, State를 일괄 생성하며, 런타임(runtime)에 이를 나열하고 설정할 수 있는 헬퍼(helper) 기능을 제공합니다.
Audio Import & Discovery (오디오 임포트 및 탐색): 대상 부모 경로 아래로 오디오 폴더를 Wwise로 임포트하며, 주어진 파일 시스템 경로 아래의 모든 오디오 파일을 나열합니다.
Soundbank Configuration & Build (사운드뱅크 구성 및 빌드): 프로젝트 메타데이터를 사용하여 선택된 객체를 사운드뱅크에 포함시키고, 지정된 플랫폼 및 언어에 대한 사운드뱅크를 생성합니다.
Runtime Audio Control (런타임 오디오 제어): 선택적 지연(delay)과 함께 이벤트를 Post하고, RTPC 램프(ramp), Switch 및 State를 설정하며, 시간에 따라 게임 객체를 이동시키고, 캡처된 세션의 모든 사운드를 중지합니다.

session.Layout & Property Utilities: Wwise 레이아웃(layout)을 토글하고, 경로를 통해 객체 속성(property)을 설정하며, 현재 선택 항목을 가져오고, 유효한 속성 이름 및 값 유형(value type)을 나열합니다. - 각 기능에 대한 자세한 설명은 Tools 페이지를 참조하십시오.

docs/- Wwise-MCP 문서 -
app/- Python 서버. Python 환경 설정에 대한 지침은 README에서 확인할 수 있습니다.
scripts/- Python 애플리케이션 소스 코드

• Wwise-MCP는 3개의 주요 Python 모듈로 구성됩니다.
• 메인 엔트리 포인트(entry point)는 wwise_mcp.py입니다.
• 반드시 Python 버전 3.13 이상을 사용하고 있는지 확인하십시오.
• 더 자세한 정보는 여기에서 확인할 수 있습니다

Apache

Built by Bilkent Samsurya

Audio Programmer | AI-integrated Audio Tools | Wwise & Unreal Specialist

Website • LinkedIn • Twitter/X

bilkentaudiodev@gmail.com 으로 언제든지 연락해 주세요.