FMOD Studio MCP Server
Executes arbitrary JavaScript in FMOD Studio's built-in Scripting Terminal over TCP (localhost:3663), allowing inspection and manipulation of the currently open FMOD project—e.g. querying the project model, listing event instances, and reading asset paths—with results returned as JSON. A static security gate blocks destructive or transport-related API calls such as transport control, recording, project close/delete/new, and file open.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FMOD Studio MCP Server
FMOD Studio の Scripting Terminal(TCP:3663)経由で FMOD Studio を操作する MCP サーバーです。 Claude Code などの MCP クライアントから、FMOD Studio 上で JavaScript を実行できます。
Architecture
MCP Client (Claude Code など)
│ stdio (JSON-RPC)
▼
fmod-studio-mcp (Python / FastMCP) ← uv / uvx で起動
│ TCP:3663 (JavaScript)
▼
FMOD Studio (内蔵 Scripting Terminal)MCP サーバー: MCP クライアントからツール呼び出しを受け取り、JavaScript を FMOD Studio の Scripting Terminal に TCP:3663 で送信し、結果を JSON で返します。
FMOD Studio: 内蔵の Scripting Terminal が TCP:3663 で待ち受け、受信した JavaScript を評価します。FMOD Studio 側に追加スクリプトは不要です。
Related MCP server: MCP QuickJS Runner
Requirements
FMOD Studio(Scripting Terminal が有効なもの)
Python 3.10+ が必要ですが、手元に無い場合は uv が自動で取得します。
MCP サーバーは FMOD Studio と同じホストで動かすことを想定しています(既定の接続先は
localhost:3663)。
uv のインストール
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | shUsage
MCP サーバーは MCP クライアントが stdio で起動します。手動でサーバーを起動しておく必要はありません。 事前に FMOD Studio を起動し、プロジェクトを開いておいてください。
A. GitHub から直接起動する(推奨)
リポジトリのクローンは不要です。uvx が GitHub から取得・キャッシュして起動します。
Claude Code に登録:
claude mcp add fmod-studio -- uvx --from git+https://github.com/yuke-x68/fmod-studio-mcp fmod-studio-mcp環境変数を指定する場合:
claude mcp add fmod-studio -e FMOD_MCP_HOST=localhost -e FMOD_MCP_PORT=3663 -- uvx --from git+https://github.com/yuke-x68/fmod-studio-mcp fmod-studio-mcpプロジェクト単位で共有したい場合は、プロジェクトルートの .mcp.json に記述します(mcp_settings_example.json と同じ内容です):
{
"mcpServers": {
"fmod-studio": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/yuke-x68/fmod-studio-mcp",
"fmod-studio-mcp"
],
"env": {
"FMOD_MCP_HOST": "localhost",
"FMOD_MCP_PORT": "3663"
}
}
}
}特定のバージョンに固定したい場合は、URL の末尾にタグやコミットを付けます(例: git+https://github.com/yuke-x68/fmod-studio-mcp@<commit-or-tag>)。
最新版への更新
uvx は取得したパッケージをキャッシュします。リポジトリの更新を取り込むには、一度 --refresh 付きで実行してください:
uvx --refresh --from git+https://github.com/yuke-x68/fmod-studio-mcp fmod-studio-mcp --helpB. ローカルのクローンから起動する
コードを編集しながら使う場合はこちら。
git clone https://github.com/yuke-x68/fmod-studio-mcp.gitClaude Code に登録(パスはクローン先の絶対パスに置き換えてください):
claude mcp add fmod-studio -- uv run --directory C:\path\to\fmod-studio-mcp fmod-studio-mcpuv run は初回起動時に .venv を自動作成し、依存関係をインストールします。
動作確認
uvx --from git+https://github.com/yuke-x68/fmod-studio-mcp fmod-studio-mcp --helpClaude Code では /mcp で fmod-studio が接続済みになっていることを確認できます。
Configuration
環境変数
Env Var | Default | Description |
|
| FMOD Studio のホスト |
|
| TCP ポート(FMOD Studio の固定ポート) |
|
| コマンドの既定タイムアウト(秒) |
|
| TCP 接続タイムアウト(秒) |
|
| TCP 受信バッファサイズ(バイト) |
|
| 接続失敗時の再試行回数 |
|
| 再試行の間隔(秒) |
コマンドライン引数
Option | Description |
| ログレベルを DEBUG にする |
| ログレベルを指定( |
ログは stderr に出力されます(stdout は MCP の JSON-RPC 通信に使用)。
引数は uvx ... fmod-studio-mcp --log-level INFO のようにコマンド末尾に付けます。
Tools
execute_script_tool
FMOD Studio の Scripting Terminal で任意の JavaScript を実行します。
引数 | 型 | 既定値 | 説明 |
| string | — | 実行する JavaScript。トップレベルで |
| int |
| 実行タイムアウト(ミリ秒) |
スクリプトは try-catch と JSON.stringify でラップされて実行され、結果は次のいずれかの JSON 文字列で返ります:
{"status": "ok", "result": <value>}
{"status": "blocked", "error": {"code": "BLOCKED", "message": "...", "detail": {...}}}
{"status": "error", "error": {"code": "<CODE>", "message": "...", "detail": {...}}}エラーコード: SYNTAX_ERROR, RUNTIME_ERROR, TIMEOUT, PARSE_ERROR, CONNECTION_ERROR
例:
return studio.project.model.Event.findInstances().map(function (e) { return e.getPath(); });セキュリティポリシー
実行前にスクリプトを静的にスキャンし、以下の API 呼び出しを含むものは FMOD Studio に送信せずブロックします(bridge/security.py)。
ブロック対象 | 理由 |
| タイムラインのトランスポート操作 |
| トランスポート・録音の制御 |
| プロジェクトを閉じる |
| プロジェクト要素の破壊的削除 |
| 現在のプロジェクトを置き換える |
| ファイルシステムへの読み書き( |
これは正規表現による簡易的なゲートであり、変数経由の間接呼び出しなどは検出できません。
Development
uv sync # .venv の作成と依存関係(開発用含む)のインストール
uv run pytest # テスト実行License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Build, run and publish 3D games in the Zero engine from Claude Code, Cursor or Codex, over MCP.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn extensible Message Communication Protocol server that provides secure code execution capabilities in isolated sandbox environments, compatible with Claude for Desktop and other MCP clients.17-
- FlicenseNot gradedqualityDmaintenanceProvides secure execution of arbitrary JavaScript code within a sandboxed QuickJS WASM environment, allowing language models or other MCP clients to safely run JavaScript code snippets without compromising the host system.5-
- AlicenseAqualityCmaintenanceAn MCP server that bridges Claude Desktop with Claude Code, allowing users to delegate tasks to Claude Code directly from Claude Desktop conversations, supporting both synchronous and background execution with session reuse.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to reach every configured MCP server through just three tools (search, describe, execute) and a sandboxed JavaScript runtime, so a model writes one short program instead of making dozens of tool calls. Runs without network, filesystem, or credential access, returning only the result.91 npm9MIT