Skip to main content
Glama

StoryboardStudio MCP

MCP-native pre-production system that generates multi-granularity storyboard assets from text prompts:

  1. 2D SVG Motion – timing-validated animation code

  2. 3D Depth / Blockout – Blender headless (bpy) Depth maps

  3. Final Look (SDXL) – ControlNet Depth-guided image generation

LLM agents (Claude Desktop, Cursor, etc.) control the entire pipeline via Stdio + FastMCP.
Includes Vision-based self-correction and a SQLite Knowledge Database of successful recipes.


Architecture

[ MCP Client ] (Claude Desktop / Cursor / Custom Agent)
     │
     ▼ (Stdio / JSON-RPC)
[ StoryboardStudio MCP Server (Python FastMCP) ]
     │
     ├─► SVG Motion Engine          → .svg
     ├─► Blender CLI Runner         → Depth / Wireframe PNG
     ├─► ComfyUI / SD-WebUI Client  → Final Image (ControlNet)
     ├─► Vision Evaluator           → Score + Refinement Delta
     └─► Knowledge Engine (SQLite)  → storyboard_knowledge.db

Related MCP server: Eversince MCP Server

Requirements

Component

Version / Notes

Python

3.11+

Blender

4.0+ (with blender in PATH)

ComfyUI or A1111

Running on 127.0.0.1:8188 or :7860

Ollama (optional)

For local Vision evaluation

GPU

RTX 3090+ recommended (target < 60 s/shot)

pip install -r requirements.txt

Quick Start

1. Initialize Knowledge DB

python scripts/init_db.py

2. Run the MCP Server

python server.py

3. Register with Claude Desktop / Cursor

Add to your MCP config (claude_desktop_config.json or Cursor settings):

{
  "mcpServers": {
    "storyboard-studio": {
      "command": "python",
      "args": ["/absolute/path/to/storyboard-studio-mcp/server.py"],
      "env": {
        "BLENDER_PATH": "blender",
        "COMFYUI_URL": "http://127.0.0.1:8188",
        "OUTPUT_DIR": "/absolute/path/to/storyboard-studio-mcp/outputs"
      }
    }
  }
}

See mcp_config.json for a ready-to-use template.


MCP Tools

Tool

Description

create_svg_anim

Save & validate SVG animation code

render_blender_blockout

Run Blender headless → Depth PNG

generate_sdxl_image

ComfyUI/WebUI + ControlNet Depth → final image

evaluate_render_vision

Vision LLM scores framing / composition

save_successful_recipe

Store high-rated camera + prompt to SQLite

search_learned_recipes

Retrieve past successful recipes by tag


Project Structure

storyboard-studio-mcp/
├── server.py                 # FastMCP entry point (all tools)
├── modules/
│   ├── blender_runner.py     # Blender CLI + Depth injection
│   ├── sdxl_client.py        # ComfyUI / A1111 API client
│   ├── vision_evaluator.py   # Vision LLM evaluation
│   └── knowledge_db.py       # SQLite recipe store
├── scripts/
│   └── init_db.py            # Create storyboard_knowledge.db
├── outputs/
│   ├── svg/
│   ├── blender/
│   └── sdxl/
├── storage/
│   └── storyboard_knowledge.db
├── tests/
├── mcp_config.json
├── requirements.txt
└── README.md

Development Roadmap (from WBS)

Phase 1 (MVP) – Core pipeline
Phase 2 – Self-Correction Loop + Knowledge Engine

See the original Technical Specifications / PRD / MRD for full details.


License

MIT


StoryboardStudio MCP – Reduce storyboard iteration friction to near zero.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers