What is Studio State?
Studio State is a small, stateless Model Context Protocol (MCP) server for AI film and video production. It reads a project's plain files to answer three questions an AI filmmaking assistant constantly needs to re-establish: orient the session, get shot status, and update a shot. It’s designed for people producing AI-generated film, video, episodic shows, and animation with tools like Higgsfield, Runway, Kling, Seedance, nano-banana, Veo, and ElevenLabs.
How to use Studio State?
Install Python 3.9+ and the MCP SDK (pip install "mcp[cli]"), set the STUDIO_ROOT environment variable to the path of your project folder, then run python3 server.py. Register the server in Claude Desktop via claude_desktop_config.json using the server’s file path and the STUDIO_ROOT environment variable.
Key features of Studio State
- Read-dominant: 2 of 3 tools are pure reads.
- Stateless: no server-side store or daemon state.
- Path-sandboxed: validated scene/episode arguments.
- Crash-proof and always current; re-reads files on every call.
- Never mutates canonical files; writes only to a sidecar
shot_status.json.
- Expects a lightweight, file-based project layout.
Use cases of Studio State
- Re-establishing production context at the start of a Claude session.
- Tracking per-shot status (planned, pending, fired, locked, needs-rework, dropped) across an episode.
- Marking a shot as fired or locked and attaching a generation job and still.
- Keeping characters, locations, and shots consistent across a long generative video production.
评论