FmodStudioMCP

FmodStudioMCP подключает любого ИИ-ассистента, совместимого с MCP, к FMOD Studio — middleware для игрового аудио — и даёт ему полный контроль над инструментом авторинга. Общайтесь с ИИ, и он создаёт события, импортирует аудио, настраивает параметры, маршрутизирует микшерные шины, назначает банки и собирает проект — пока вы наблюдаете, как редактор применяет каждое изменение в реальном времени.

Он работает через встроенный JavaScript-терминал сценариев FMOD Studio (TCP, порт 3663), поэтому — как и его аналог ReaperMCP — не требует плагинов, облака или установки чего-либо внутрь инструмента: FMOD Studio уже содержит мост. MCP-сервер — единственный новый компонент, и он общается со стандартной установкой FMOD Studio.

Если этот проект вам полезен, поставьте звёздочку — это помогает другим найти его.

Совместимость

• Claude Desktop, Cursor или любой MCP-совместимый клиент

Быстрый старт

1. Установите FmodStudioMCP

Установите напрямую:

pip install xdarkzx-fmod-studio-mcp

или склонируйте репозиторий и выполните pip install -e . для разработки (см. CONTRIBUTING.md).

2. Включите Script Server в FMOD Studio (один раз)

Терминал сценариев отключён по умолчанию, и открытие консоли через Ctrl+0 недостаточно — она только показывает вывод.

1. Запустите FMOD Studio и откройте ваш проект (.fspro).

2. Edit → Preferences… (Windows) или FMOD Studio → Preferences… (macOS).

3. На вкладке Interface отметьте Enable Script Server (requires restart).

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», каждый инструмент здесь вручную продуман под реальный рабочий процесс авторинга. 90+ инструментов в 13 модулях —

Типизировано и безопасно по умолчанию

• Каждая команда — это операция со схемой и валидацией — никакого произвольного выполнения скриптов (та же политика, что и в ReaperMCP).

• Значения проверяются до отправки в Studio (имена, диапазоны дБ, белые списки типов, пути/расширения аудиофайлов).

• Параметры передаются как инертные JSON-литералы в самозапирающуюся JS-обёртку — враждебная строка не сможет выйти за пределы кавычек или добраться до тела команды.

• Результаты ограничиваются (MAX_OBJECTS_READ и т.д.), чтобы загруженный проект не переполнил контекстное окно вашей модели.

Управляемый набор инструментов

Модели поменьше/подешевле урезают списки инструментов. Установите FMOD_STUDIO_MCP_PROFILE в конфиге сервера вашего клиента, чтобы выбрать подмножество под ваш рабочий процесс:

Промышленная надёжность, как в ReaperMCP

• TCP-мост с кадрированием «читай до простоя» и типизированными ошибками соединения/таймаута (никаких молчаливых зависаний).

• Межпроцессный файловый мьютекс, чтобы несколько MCP-клиентов могли работать с одной студией, не перемешивая свои оценки.

• Архив истории команд (хранение 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 и ИИ общаются через localhost.

Подробности — кадрирование, обёртка, лимиты безопасности, жизненный цикл — в docs/ARCHITECTURE.md.

Устранение неполадок

Разработка

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

Добавление инструмента

1. Добавьте модуль в fmod_mcp/tools/ (или расширьте существующий).

2. Экспортируйте register(mcp: FastMCP).

3. Определите инструменты с помощью @mcp.tool(), используя хелпер client.execute("js body", **params).

4. Добавьте имя модуля в _EXPECTED_MODULES в tool_registry.py.

5. Каждый новый инструмент автоматически проверяется тестовым каркасом в tests/test_tools_registration.py.

Полные рекомендации см. в CONTRIBUTING.md.

Лицензия

Apache License 2.0 — подробности в LICENSE.

Создано Дэниелом Ходжеттсом (@xDarkzx).

Нужен нестандартный инструмент, плагин или интеграция в таком же стиле? Откройте issue.