FmodStudioMCP

FmodStudioMCP는 MCP 호환 AI 어시스턴트를 게임 오디오 미들웨어인 FMOD Studio에 연결하여 저작 도구를 완전히 제어할 수 있게 해 줍니다. AI에게 말을 걸면 이벤트를 만들고, 오디오를 가져오고, 파라미터 컬처를 구축하고, 믹서 버스를 라우팅하고, 뱅크를 할당하고, 프로젝트를 빌드합니다. 그동안 에디터가 모든 변경 사항을 실시간으로 적용하는 것을 지켜볼 수 있습니다.

이 도구는 FMOD Studio의 내장 JavaScript 스크립팅 터미널(TCP, 포트 3663)을 통해 실행되므로, ReaperMCP와 마찬가지로 플러그인도, 클라우드도, 도구 내부에 설치할 항목도 없습니다. FMOD Studio가 브리지를 제공합니다. MCP 서버만 새로 추가되며, 표준 FMOD Studio 설치본과 통신합니다.

이 프로젝트가 유용하다면 스타 하나가 다른 사람들이 찾는 데 도움이 됩니다.

호환 제품

• Claude Desktop, Claude Code, Cursor 또는 모든 MCP 호환 클라이언트

빠른 시작

1. FmodStudioMCP 받기

직접 설치:

pip install xdarkzx-fmod-studio-mcp

또는 개발용으로 클론 후 pip install -e .를 실행하세요 (CONTRIBUTING.md 참조).

2. FMOD Studio 스크립트 서버 활성화(1회)

스크립팅 터미널은 기본적으로 비활성화되어 있으며, Ctrl+0으로 콘솔을 여는 것만으로는 부족합니다. 출력만 표시될 뿐입니다.

1. FMOD Studio를 실행하고 프로젝트(.fspro)를 엽니다.

2. Edit → Preferences…(Windows) 또는 FMOD Studio → Preferences…(macOS)를 선택합니다.

3. Interface 탭에서 **Enable Script Server(다시 시작해야 함)**를 선택합니다.

4. FMOD Studio를 종료하고 다시 시작한 후 프로젝트를 다시 엽니다. 포트는 기본적으로 3663입니다.

수신 대기 중인지 확인하시겠어요? %LOCALAPPDATA%\FMOD Studio\Logs\에서 가장 최근 로그에 [Scripting] ScriptServer started on 127.0.0.1 (3663)이 있는지 확인하세요.

3. MCP 클라이언트에 서버 등록

{
  "mcpServers": {
    "fmod-studio": {
      "command": "fmod-studio-mcp"
    }
  }
}

fmod-studio-mcp는 설정이 다를 경우 FMOD_STUDIO_HOST / FMOD_STUDIO_PORT(기본값 127.0.0.1:3663)를 읽습니다.

4. 저작 시작

"List every event in the project"
"Create an event called 'Player/Footsteps' with a SingleSound loop of footsteps.wav"
"Add a 'Fear' User parameter to it, range 0-1, initial 0"
"Assign it to the Master bank and build the project"

FMOD Studio가 프로젝트를 연 상태로 실행 중이어야 합니다. 브리지가 Studio를 대신 실행할 수 없으며, Script Server는 프로젝트가 열려 있어야만 바인딩됩니다.

Related MCP server: fmod-mcp

기능

엄선된 도구 표면(생성 아님)

자동 생성된 'API 멤버당 도구 하나' 서버와 달리 여기의 모든 도구는 실제 저작 워크플로에 맞춰 수작업으로 제작되었습니다. 13개 모듈에 90개 이상의 도구가 있습니다 —

기본적으로 타입이 지정되고 안전

• 모든 명령은 명명되고 스키마로 검증된 작업입니다. 임의 스크립트 탈출구가 없습니다(ReaperMCP와 동일한 정책).

• 값은 Studio에 도달하기 전에 검증됩니다(이름, dB 범위, 유형 허용 목록, 오디오 파일 경로/확장자).

• 매개변수는 비활성 JSON 리터럴로 자체 포착 JavaScript 래퍼에 전달되므로 악의적인 문자열이 따옴표를 벗어나거나 명령 본문에 도달할 수 없습니다.

• 결과는 제한되어(MAX_OBJECTS_READ 등) 바쁜 프로젝트에서도 모델의 컨텍스트 창이 넘치지 않습니다.

프로필로 다듬을 수 있는 도구 표면

더 작고 저렴한 모델은 도구 목록을 자릅니다. 클라이언트의 서버 구성에 FMOD_STUDIO_MCP_PROFILE을 설정하여 워크플로별 하위 집합을 선택하세요:

ReaperMCP와 동일한 프로덕션급 배관

• 읽기-유휴까지 프레이밍 + 유형화된 연결/시간 초과 오류가 있는 TCP 브리지(조용한 중단 없음).

• 프로세스 간 파일 뮤텍스로 여러 MCP 클라이언트가 평가를 서로 방해하지 않고 하나의 Studio를 공유할 수 있습니다.

• 사후 디버깅을 위한 명령 기록 아카이브(30일 보존).

• 시작 시 UTF-8 stdio 수정 및 자동 종료 상위 감시 프로세스 — ReaperMCP에서 물려받은 전투 테스트를 거친 클라이언트 동작.

아키텍처

┌──────────────┐    stdio    ┌──────────────┐    TCP 3663    ┌──────────────┐
│  MCP Client  │◄──────────►│ FmodStudioMCP│◄──────────────►│ FMOD Studio  │
│(AI assistant)│  (JSON-RPC) │   FastMCP    │  (JS eval)     │ (JS terminal)│
└──────────────┘             └──────────────┘                └──────────────┘

Python 서버는 모든 도구의 명령 본문을 자체 평가되고 오류를 포착하는 JavaScript IIFE로 감싸 Script Server로 보내고, 문자열 응답을 다시 구조화된 결과로 구문 분석합니다. 클라우드가 없습니다. 어떤 것도 기기를 떠나지 않습니다. Studio와 AI는 localhost를 통해 통신합니다.

전체 세부 정보(프레이밍, 래핑, 안전 제한, 수명 주기)는 docs/ARCHITECTURE.md 를 참조하세요.

문제 해결

개발

pip install -e ".[dev]"
pytest tests/ -x -q
ruff check .

도구 추가

1. fmod_mcp/tools/에 모듈을 추가하거나(또는 기존 모듈 확장) fmod_mcp/tools/에 모듈을 추가합니다.

2. register(mcp: FastMCP)를 내보냅니다.

3. client.execute("js body", **params) 헬퍼를 사용하여 @mcp.tool()로 도구를 정의합니다.

4. tool_registry.py의 _EXPECTED_MODULES에 모듈 이름을 추가합니다.

5. 모든 새 도구는 tests/test_tools_registration.py의 테스트 하니스에서 자동으로 실행됩니다.

전체 가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

Apache License 2.0 — 자세한 내용은 LICENSE를 참조하세요.

Daniel Hodgetts(@xDarkzx) 제작.

이와 같은 맞춤형 도구, 플러그인 또는 통합이 필요하신가요? 이슈를 열어 주세요.