FmodStudioMCP

FmodStudioMCP conecta cualquier asistente de IA compatible con MCP con FMOD Studio, el middleware de audio para videojuegos, y le da control total sobre la herramienta de autoría. Habla con tu IA y ella crea eventos, importa audio, construye culturas de parámetros, enruta buses de mezclador, asigna bancos y compila tu proyecto, mientras ves cómo el editor aplica cada cambio en vivo.

Funciona a través de la terminal de scripting JavaScript integrada de FMOD Studio (TCP, puerto 3663), por lo que, al igual que su hermano ReaperMCP, no hay plugin, ni nube, ni nada que instalar dentro de la herramienta: FMOD Studio incluye el puente. El servidor MCP es la única pieza nueva, y se comunica con una instalación estándar de FMOD Studio.

Si te resulta útil, una estrella ayuda a que otras personas lo encuentren.

Funciona con

• Claude Desktop, Claude Code, Cursor o cualquier cliente compatible con MCP

Inicio rápido

1. Obtén FmodStudioMCP

Instala directamente:

pip install xdarkzx-fmod-studio-mcp

o clona el repositorio y ejecuta pip install -e . para desarrollo (consulta CONTRIBUTING.md).

2. Habilita el Script Server de FMOD Studio (una sola vez)

La terminal de scripting está deshabilitada por defecto, y abrir la consola con Ctrl+0 no es suficiente; eso solo muestra la salida.

1. Inicia FMOD Studio y abre tu proyecto (.fspro).

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

3. En la pestaña Interfaz, marca Habilitar Script Server (requiere reinicio).

4. Sal y relanza FMOD Studio y vuelve a abrir el proyecto. El puerto es 3663 por defecto.

¿Confirmado que está escuchando? Revisa el registro más reciente en %LOCALAPPDATA%\FMOD Studio\Logs\ para ver [Scripting] ScriptServer started on 127.0.0.1 (3663).

3. Registra el servidor en tu cliente MCP

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

fmod-studio-mcp lee FMOD_STUDIO_HOST / FMOD_STUDIO_PORT (valores por defecto 127.0.0.1:3663) si tu configuración es diferente.

4. Empieza a crear

"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 debe estar ejecutándose con un proyecto abierto. El puente no puede iniciar Studio por ti, y el Script Server solo se vincula cuando hay un proyecto abierto.

Related MCP server: fmod-mcp

Características

Superficie de herramientas seleccionadas (no generadas)

A diferencia de los servidores autogenerados de «una herramienta por miembro de la API», cada herramienta aquí está diseñada a mano en torno al flujo de trabajo real de autoría. Más de 90 herramientas en 13 módulos —

Tipado, seguro por defecto

• Cada comando es una operación nombrada y validada por esquema: sin vía de escape de scripts arbitrarios (misma política que ReaperMCP).

• Los valores se validan antes de llegar a Studio (nombres, rangos de dB, listas blancas de tipos, rutas/extensiones de archivos de audio).

• Los parámetros viajan como literales JSON inertes dentro de un envoltorio JS autocontenido: una cadena hostil no puede escapar de sus comillas ni llegar al cuerpo del comando.

• Los resultados están limitados (MAX_OBJECTS_READ, etc.) para que un proyecto muy cargado no inunde la ventana de contexto de tu modelo.

Superficie de herramientas recortable por perfil

Los modelos más pequeños/económicos truncan las listas de herramientas. Configura FMOD_STUDIO_MCP_PROFILE en la configuración del servidor de tu cliente para elegir un subconjunto específico del flujo de trabajo:

Infraestructura de nivel de producción, igual que ReaperMCP

• Puente TCP con tramado read-until-idle + errores de conexión/tiempo de espera tipados (nunca un bloqueo silencioso).

• Mutex de archivo entre procesos para que varios clientes MCP puedan compartir un Studio sin que sus evaluaciones se intercalen.

• Archivo de historial de comandos (retención de 30 días) para depuración posterior.

• Corrección de stdio UTF-8 al inicio y un watchdog del proceso padre que se retira solo: comportamiento de cliente probado en batalla, heredado de ReaperMCP.

Arquitectura

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

El servidor Python envuelve el cuerpo del comando de cada herramienta en una IIFE de JavaScript autoevaluable y con captura de errores, la envía al Script Server y analiza la respuesta de cadena para convertirla en un resultado estructurado. Sin nube. Nada sale de tu máquina: Studio y la IA se comunican a través de localhost.

Todos los detalles (tramado, envoltura, límites de seguridad, ciclo de vida) en docs/ARCHITECTURE.md.

Solución de problemas

Desarrollo

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

Añadir una herramienta

1. Añade un módulo en fmod_mcp/tools/ (o amplía uno existente).

2. Exporta register(mcp: FastMCP).

3. Define herramientas con @mcp.tool(), usando el helper client.execute("js body", **params).

4. Añade el nombre del módulo a _EXPECTED_MODULES en tool_registry.py.

5. Cada nueva herramienta se ejercita automáticamente mediante el banco de pruebas en tests/test_tools_registration.py.

Consulta CONTRIBUTING.md para obtener las pautas completas.

Licencia

Apache License 2.0: consulta LICENSE para más detalles.

Creado por Daniel Hodgetts (@xDarkzx).

¿Necesitas una herramienta, un plugin o una integración personalizada como esta? Abre un issue.