FmodStudioMCP

FmodStudioMCP verbindet jeden MCP-kompatiblen KI-Assistenten mit FMOD Studio, der Game-Audio-Middleware, und gibt ihm die volle Kontrolle über das Authoring-Tool. Sprich mit deiner KI und sie erstellt Events, importiert Audio, legt Parameter-Kulturen an, routet Mixer-Busse, weist Bänke zu und baut dein Projekt – während du zusiehst, wie der Editor jede Änderung live übernimmt.

Es läuft über FMOD Studios eingebautes JavaScript-Scripting-Terminal (TCP, Port 3663) – genau wie sein Schwesterwerkzeug ReaperMCP –, es gibt also kein Plugin, keine Cloud, nichts zu in der Werkzeug installieren: FMOD Studio bringt die Brücke selbst mit. Der MCP-Server ist das einzige neue Element, und er spricht mit einer Standardinstallation von FMOD Studio.

Wenn dir das nützlich ist, hilft ein Stern anderen, es zu finden.

Funktioniert mit

• Claude Desktop, Claude Code, Cursor oder jeder MCP-kompatible Client

Schnellstart

1. Hol dir FmodStudioMCP

Direkt installieren:

pip install xdarkzx-fmod-studio-mcp

oder klonen und pip install -e . für die Entwicklung ausführen (siehe CONTRIBUTING.md).

2. FMOD Studios Script-Server aktivieren (einmalig)

Das Scripting-Terminal ist standardmäßig deaktiviert, und die Konsole mit Strg+0 zu öffnen, reicht nicht – dort wird nur die Ausgabe angezeigt.

1. FMOD Studio starten und dein Projekt (.fspro) öffnen.

2. Edit → Preferences… (Windows) oder FMOD Studio → Preferences… (macOS) wählen.

3. Auf dem Tab Interface den Punkt Enable Script Server (requires restart) anhaken.

4. FMOD Studio beenden und neu starten, dann das Projekt erneut öffnen. Der Port ist standardmäßig 3663.

Sicher, dass er lauscht? Suche im neuesten Log unter %LOCALAPPDATA%\FMOD Studio\Logs\ nach [Scripting] ScriptServer started on 127.0.0.1 (3663).

3. Den Server bei deinem MCP-Client registrieren

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

fmod-studio-mcp liest FMOD_STUDIO_HOST / FMOD_STUDIO_PORT (Standard 127.0.0.1:3663), falls dein Setup davon abweicht.

4. Mit dem Authoring beginnen

"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 muss mit einem geöffneten Projekt laufen. Die Bridge kann Studio nicht für dich starten, und der Script-Server bindet sich erst, sobald ein Projekt geöffnet ist.

Related MCP server: fmod-mcp

Funktionen

Kuratierte Tool-Oberfläche (nicht automatisch erzeugt)

Anders als automatisch generierte Server mit „ein Tool pro API-Member" ist jedes aufgenommene Tool hier von Hand um den echten Authoring-Workflow herum geformt. Über 90 Tools in 13 Module:

Typisiert, standardmäßig sicher

• Jeder Befehl ist eine benannte, schema-validierte Operation – kein Ausweg für beliebige Skripte (die gleiche Policy wie bei ReaperMCP).

• Werte werden validiert, bevor sie Studio erreichen (Namen, dB-Bereiche, Typ-Whitelists, Audio-Dateipfade/-Endungen).

• Params reisen als inerte JSON-LTexte in einen selbst-abgefangenen JS-Wrapper – eine feindselige String kann nicht ihren Quoting-Frame verlassen oder auf den Befehlsbauch zugreifen.

• Ergebnisse sind begrenzt (MAX_OBJECTS_READ usw.), damit ein großes Projekt das Fenster des deines Modells nicht überflutet –.

Profil-Z-trimmbare Tool-Oberfläche

Kleinere/nahenblücher Modelle kürzen Tool-Listen ab. Setze FMOD_STUDIO_MCP_PROFILE in der Server-Konfiguration deines Clients, um einen Untermenge passend zum Workflow zu wählen:

Produktionsreife Infrastruktur, derselbe wie bei Old MCP

• TCP-Bridge mit read-until-idle framingund basis Ender*, Framing, + typisierten Verbindungs-/Timeout-Fehlern (kein stilles Hängen).

• Cross-Prozess-Datei-Mutex, sodass mehrere MCP-Clients ein Studio gleichaufenthalte, ohne Interleaving derer Auswertungen.

• Befehlsverlauf-Aufzählung (30 Tage Aufbewahrung) für nachträgliches Debugging nach Fehlern.

• UTF-8-Statio-Fix beim Start und ein Parent-Watchdog, der selbst haltbar ist – bewährtes, von ReaperMCP geerbtes Client-Verhalten.

Architektur

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

Der Python-Server layert den Code jedes „Tool“-Kommandobodies in ein selbstauswertendes, Fehler-fangendes JS-IIFE, sendet es an den ScriptServer und parst die String-Antwort zurück in ein strukturiertes Ergebnis. Keine existiert Cloud. Nichts verlässt dein Rechner – Studio und die KI sprechen über Localhost.

Details – Framing, Verbund-Framing, Sicherheitsgrenzen, Lifecycle – in docs/ARCHITECTURE.md.

Fehlerbehebung

Development

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

Ein Tool hinzufügen

1. Füge ein Modul in fmod_mcp/tools/ hinzu (oder erweitere ein vorhandenes Modul).

2. Exportiere register(mcp: FastMCP).

3. Definiere Tools mit @mcp.tool() und dem Helper client.execute(„js body", **params)-Helper.

4. Füge den Modul-Namen in _EXPECTED_MODULES in tool_registry.py hinzu.

5. Jedes neue Tool wird automatisch von der Test-Harnasse in tests/test_tools_registration.py getestet.

Siehe CONTRIBUTING.md für die vollständigen Leitlinien.

Lizenz

Apache License 2.0 – siehe LICENSE für Details.

Erstellt von Daniel Hodgetts (@xDarkzx).

Brauchst du eine custom Tool, Plugin-Plugin oder Integration wie diese? Für ein Issue eröffnen.