Auto CM Director MCP Server

The Agentic Video Generation Framework.

README.md

šŸŽ¬ Auto Director

The Agentic Video Generation Framework. A hybrid engine designed for AI Agents to autonomously direct, edit, and render high-quality promotional videos for any software project.

šŸŽ„ Watch the Demo: YouTube


āš”ļø Quick Start

For Humans šŸ§‘ā€šŸ’»

Instantly initialize Auto Director in your repository.

npx auto-director init

This will:

  1. Ask for your project name & theme (Cyberpunk / Minimal / Playful).
  2. Scaffold a video/ directory with the engine.
  3. Generate a starter director.json.

Then, render your video:

cd my-video-project
npm install
npm run build -- --props=./director.json

For Agents šŸ¤–

If you are an AI (Claude, ChatGPT, etc.) using this tool via MCP (Model Context Protocol):

1. Install the MCP Server Add this to your client configuration:

{
  "mcpServers": {
    "auto-director": {
      "command": "node",
      "args": ["/path/to/auto-director/packages/mcp-server/dist/index.js"]
    }
  }
}

2. Use the Tool Call generate_commercial with the repository context.


🧠 The Hybrid Architecture

Unlike traditional "Text-to-Video" tools that hallucinate random clips, Auto Director uses a Hybrid Template Engine:

  1. AI (The Creative Director): Analyzes the repository, extracts the "Vibe" (Cyberpunk, Minimal, Playful), and generates a structured director.json configuration.
  2. Engine (The Renderer): A robust Remotion-based Universal Template renders the video with high-end animations, guaranteeing a perfect compile every time.

šŸŽØ Themes

Theme Vibe Best For
Cyberpunk Glitch, Neon, Dark Mode Crypto, DevTools, CLI
Minimal Clean, Helvetica, Fade SaaS, Notion Templates
Playful Bouncy, Pastel, Rounded Consumer Apps, Games

šŸ›  Project Structure

.
ā”œā”€ā”€ bin/                # CLI Entry Point
ā”œā”€ā”€ packages/           #
│   └── mcp-server/     # Model Context Protocol Server
ā”œā”€ā”€ src/
│   ā”œā”€ā”€ templates/      # UniversalCommercial.tsx (The Core)
│   ā”œā”€ā”€ components/     # Reusable UI (KineticText, MacWindow)
│   └── Scenes/         # Feature implementations
└── director.json       # The "Script" (AI generates this)

šŸ¤– Agent Registration (Advanced)

To make this repository discoverable by other AI agents (Claude, Windsurf, etc.), we recommend registering it on Glama or Smithery.

**Recommended: Glama**

  1. Go to Glama MCP Servers.
  2. Log in with GitHub.
  3. Click "Add Server" and select the auto_CM_director repository.
  4. The system will automatically detect the capabilities via the included configuration file.

**Alternative: Smithery**

  1. Go to Smithery.
  2. Submit the repository URL: https://github.com/naki0227/auto_CM_director.

šŸ¤ Contributing

We welcome Pull Requests from both biological and artificial intelligence. See CONTRIBUTING.md for the Agentic Guide.


License: MIT Created by: You & Your Agents.

Tools 1

generate_commercialGenerates a promotional video for a software project based on repository context.

Try it

→Generate a promotional video for my current project using the Cyberpunk theme.
→Create a marketing video for this repository that highlights our new CLI features.
→Direct a short promotional clip for my SaaS project using the Minimal theme.

Frequently Asked Questions

What are the key features of Auto CM Director?

Autonomous direction and editing of promotional videos. Hybrid template engine using Remotion for high-quality rendering. AI-driven script and configuration generation via director.json. Support for multiple visual themes including Cyberpunk, Minimal, and Playful.

What can I use Auto CM Director for?

Creating promotional videos for open-source software projects. Generating marketing content for SaaS products directly from repository context. Automating the creation of demo videos for CLI tools and developer utilities.

How do I install Auto CM Director?

Install Auto CM Director by running: node /path/to/auto-director/packages/mcp-server/dist/index.js

What MCP clients work with Auto CM Director?

Auto CM Director works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Auto CM Director docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare