FmodStudioMCP

FmodStudioMCP は、MCP 対応の AI アシスタントをゲームオーディオツール FMOD Studio（https://www.fmod.com/）に接続し、オーサリングツールを完全に制御できるようにします。AI に話しかけるだけで、イベントの作成、オーディオアセットの配置、ミキサーバスの構築、パラメータカルチャーの作成、プロジェクトのビルドを実行できます。その間、あなたはエディタの動作をそのまま見守ることができます。

これは FMOD Studio の JavaScript スクリプトターミナル（TCP、ポート 3663）経由で動作します。つまり ReaperMCP と同じく、プラグイン不要・クラウド不要・追加インストール不要です。FMOD Studio 自体がブリッジを備えています。この MCP サーバーが唯一の新しい部品であり、FMOD Studio の標準インストールと通信するだけです。

これが役に立つと感じたら、スターを付けてもらえると他の人の目に留まりやすくなります。

クイックスタート

1. FmodStudioMCP を入手する

直接インストール:

pip install xdarkzx-fmod-studio-mcp

またはリポジトリをクローンして開発用に pip install -e .（CONTRIBUTING.md を参照）。

2. FMOD Studio のスクリプトサーバーを有効にする（一度だけ）

スクリプトターミナルはデフォルトで無効になっており、Ctrl+0 を押してコンソールを開くだけでは不十分です。表示されるだけで、出力は得られません。

1. FMOD Studio を起動し、プロジェクト(.fspro)を開きます。

2. （Windows）Edit → Preferences…、または（macOS）FMOD Studio → Preferences… を選択します。

3. Interface タブで Enable Script Server（スクリプトサーバーを有効化） にチェックを入れます。

4. FMOD Studio を終了して再起動し、プロジェクトを開き直します。ポートはデフォルトで 3663 です。

確認できましたか？ %LOCALAPPDATA%\FMOD Studio\Logs\ の最新ログで [ScriptServer] 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 メンバーごとに1ツール」方式とは異なり、各ツールは実際のオーサリングワークフローに合わせて手作業で設計されています。13 モジュール、全ツール —

型付きで、安全に

AI が送るコマンドはすべて、名前付きスキーマで検証されます。FMOD Studio に送信されるのは、自己トラップする JS ラッパーで包まれたコマンドのみで、生のコードを実行する「エスケープハッチ」はありません。すべての応答は構造化された JSON として返されます（ツールの説明にスキーマが記載されています）。

本番品質の配管（ReaperMCP から継承）

• TCP ブリッジは「空読みまで読み取る」フレーミング + 型付きの接続/タイムアウトエラー。サイレントハングはありません。

• 複数の MCP クライアントが1つの Studio を共有しても評価が重ならないよう、プロセス間ファイルミューテックスを使用。

• 30日間のコマンド履歴アーカイブで、あとからデバッグ可能。

• 起動時の UTF-8 stdio 修正と、自分で終了する親ウォッチドッグ。

アーキテクチャ

┌──────────────┐    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 を参照。

トラブルシューティング

開発

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

ツールの追加

1. fmod_studio_mcp/tools/<category>.py に、@tool デコレータを使った関数として実装します。

2. fmod_studio_mcp/server.py の TOOL_REGISTRY に追加します。

3. fmod_studio_mcp/tests/ にテストを追加します。

4. make test で全テストを実行します。

完全なドキュメント — フレーミング、ラッピング、セキュリティ、ライフサイクル — は docs/ARCHITECTURE.md にあります。

トラブルシューティング

開発

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

ツールの追加

1. fmod_studio_mcp/tools/ に新しいモジュール（または既存モジュール）を追加します。

2. 各ツールは @mcp.tool() で登録された非同期関数です（例: fmod_studio_mcp/tools/events.py を参照）。

3. fmod_studio_mcp/server.py の MODULES リストにモジュールを追加します。

4. テストを tests/ に追加し、make test を実行します。

5. ドキュメント（README / docs）を更新します。

完全な開発ガイドは CONTRIBUTING.md を参照してください。

ライセンス

MIT — 詳細は LICENSE を参照してください。