Skip to main content
Glama
andrewsetness

project-fmod-api

by andrewsetness
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

project-fmod-api

Bounded FMOD Studio game-audio automation for MCP/CLI workflows and engine handoff.

Purpose

This repository is the durable AI-facing game-audio automation layer for the game-development stack. It integrates FMOD Studio with MCP/CLI workflows and project-unity-api while preserving FMOD Studio as the authority for authored audio project state.

Related MCP server: apc-mcp

What belongs here

  • Stable normalized schemas for FMOD project state

  • Inspection contracts and snapshots

  • Safe mutation policy, previews, and receipts

  • High-level game-audio workflows (events, assets, parameters, adaptive music, spatial audio, banks, mixer/routing)

  • CLI (fmod-api) and MCP adapters

  • Operation receipts, validation, artifact manifests, and drift detection

  • Agent guidance and integration handoff contracts

What does not belong here

  • Generative sound/music models or audio asset marketplaces

  • FMOD Studio, FMOD Engine, or proprietary FMOD SDK binaries (users install FMOD separately under FMOD's licensing terms)

  • Unrestricted JavaScript evaluation against FMOD Studio

  • Production Unity project mutation (owned by project-unity-api)

  • Subjective mix/artistic quality judgment from deterministic tests

Quick start

# Install in development mode
pip install -e ".[dev]"

# Verify the installation
fmod-api --version
fmod-api doctor
fmod-api qualify

Required checks

python -m ruff check .
python -m mypy src
python -m pytest -q

FMOD authority boundary

FMOD Studio is authoritative for FMOD project objects, events, parameters, mixer/routing state, and bank builds. This repository owns the normalized inspection, safe mutation policy, and high-level workflows — it does not replace FMOD Studio.

Safety

No arbitrary model-supplied JavaScript/eval surface is exposed as a normal agent tool. All operations are typed, schema-validated, and explicitly targeted. See SECURITY.md.

License

This repository is not yet licensed. See repository owner for terms.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • apc-mcp

    sgm-audio
    A
    license
    Not graded
    quality
    B
    maintenance
    apc-mcp is a Model Context Protocol server that brings audio plugin development workflows into any MCP-compatible client by wrapping CMake, ctest, clang-format, pluginval, and clap-validator into a clean tool interface for building, testing, linting, validating, and scaffolding JUCE, CLAP, VST3, and ARA plugin projects.
    MIT

  • fmod-studio-mcp

    EYamanS
    A
    license
    C
    quality
    C
    maintenance
    An MCP server that drives FMOD Studio live through its scripting terminal, exposing the FMOD Studio Scripting API as MCP tools for immediate project editing.
    100
    13
    MIT