VideoDB Director

by video-db

47 499 downloads Not rated yet

GitHub Website

About

An open-source agent toolkit that auto-syncs SDK versions, docs, and examples—built for seamless integration with LLMs, and AI agents ( MCP compatible).

Explore

- Integrates with VideoDB’s video database platform
- Runs via the lightweight uvx package runner
- Supports automated install in Claude and Cursor
- Requires only a VideoDB API key for authentication
- Can be updated to latest version with uv cache clean

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name VideoDB Director

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

From the repository

We need to install uv first.

For macOS/Linux:
``curl -LsSf https://astral.sh/uv/install.sh | sh`For Windows:`powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`You can also visit the installation steps ofuv for more details here

You can configure VideoDB Director MCP server in Claude and Cursor together, by running the following command`uvx videodb-director-mcp --install=all



claude mcp add videodb-director uvx -- videodb-director-mcp --api-key=<VIDEODB_API_KEY>

`doc_assistant`

Context for creating video applications using VideoDB

`code_assistant`

Will give you data related to VideoDB SDK which allows developers to use videodb in python. IMPORTANT: Whenever user wants to write code related to videos, youtube videos or VideoDB specifically, always call this tool.

`play_video`

Play the video of the given stream link

`call_director`

The Director tool orchestrates specialized agents within the VideoDB server, efficiently handling multimedia and video-related queries. Clients should send queries that Director can interpret clearly, specifying tasks in natural language. Director will then delegate these queries to appropriate agents for optimized results, utilizing defaults and contextual information if explicit parameters are not provided. Director handles queries such as: - Uploading & Downloading: - Upload media from URLs or local paths (supported media: video, audio, image) - Download the VideoDB generated video streams. - Indexing & Search: - Index spoken words or scenes in videos (spoken_words, scene indexing; scene indexing supports shot or time-based type) - Search VideoDB collections semantically or by keyword (semantic, keyword search; indexing types: spoken_word, scene) - Summarization & Subtitles: - Summarize video content based on custom prompts - Add subtitles in various languages - Dubbing: - Dub videos into target languages - Creating Videos: - Generate videos using specific models or engines (Fal, StabilityAI; job types: text_to_video, image_to_video) - Compare multiple video generation models (video_generation_comparison) - Audio Generation & Editing: - Generate speech, sound effects, or background music (engines: ElevenLabs for speech/sound effects, Beatoven for music) - Clone voices from audio sources or overlay cloned voices onto videos - Censor the video on given prompt - Image and Frame Generation: - Generate static image frames from videos at specified timestamps - Create or enhance images using GenAI models (job types: text_to_image, image_to_image using Fal, Replicate) - Video Editing & Clip Generation: - Edit or combine multiple videos and audio files - Generate targeted video clips from user prompts - Streaming & Web Search: - Stream videos by video ID or URL - Search for relevant online videos (engine: Serp) - Transcription: - Generate transcripts for videos - Pricing & Usage Information: - Provide detailed cost information and usage estimates - Meeting Recording & Analysis: - Record meetings - Deploy recording bots to Zoom, Google Meet, or Microsoft Teams - Analyze recorded meetings for AI-driven insights - Intelligently index and summarize meetings Clients should provide queries clearly aligned with Director's capabilities, allowing Director to use contextual defaults when explicit parameters like IDs or collection details are not specified. IMPORTANT: if you have a previous response of this method with an appropriate session_id, please provide that session_id in the next request to continue the conversation. IMPORTANT: It is MANDATORY to send the `session_id` param if any earlier response from this method exists with a `session_id` in its output

- doc_assistant: Context for creating video applications using VideoDB
- code_assistant: Will give you data related to VideoDB SDK which allows developers to use videodb in python. IMPORTANT: Whenever user wants to write code related to videos, youtube videos or VideoDB specifically, always call this tool.
- play_video: Play the video of the given stream link
- call_director: The Director tool orchestrates specialized agents within the VideoDB server, efficiently handling multimedia and video-related queries. Clients should send queries that Director can interpret clearly, specifying tasks in natural language. Director will then delegate these queries to appropriate agents for optimized results, utilizing defaults and contextual information if explicit parameters are not provided.

Director handles queries such as:

- Uploading & Downloading:
- Upload media from URLs or local paths (supported media: video, audio, image)
- Download the VideoDB generated video streams.

- Indexing & Search:
- Index spoken words or scenes in videos (spoken_words, scene indexing; scene indexing supports shot or time-based type)
- Search VideoDB collections semantically or by keyword (semantic, keyword search; indexing types: spoken_word, scene)

- Summarization & Subtitles:
- Summarize video content based on custom prompts
- Add subtitles in various languages

- Dubbing:
- Dub videos into target languages

- Creating Videos:
- Generate videos using specific models or engines (Fal, StabilityAI; job types: text_to_video, image_to_video)
- Compare multiple video generation models (video_generation_comparison)

- Audio Generation & Editing:
- Generate speech, sound effects, or background music (engines: ElevenLabs for speech/sound effects, Beatoven for music)
- Clone voices from audio sources or overlay cloned voices onto videos
- Censor the video on given prompt

- Image and Frame Generation:
- Generate static image frames from videos at specified timestamps
- Create or enhance images using GenAI models (job types: text_to_image, image_to_image using Fal, Replicate)

- Video Editing & Clip Generation:
- Edit or combine multiple videos and audio files
- Generate targeted video clips from user prompts

- Streaming & Web Search:
- Stream videos by video ID or URL
- Search for relevant online videos (engine: Serp)

- Transcription:
- Generate transcripts for videos

- Pricing & Usage Information:
- Provide detailed cost information and usage estimates

- Meeting Recording & Analysis:
- Record meetings
- Deploy recording bots to Zoom, Google Meet, or Microsoft Teams
- Analyze recorded meetings for AI-driven insights
- Intelligently index and summarize meetings

Clients should provide queries clearly aligned with Director's capabilities, allowing Director to use contextual defaults when explicit parameters like IDs or collection details are not specified.

IMPORTANT: if you have a previous response of this method with an appropriate session_id, please provide that session_id in the next request to continue the conversation.
IMPORTANT: It is MANDATORY to send the session_id param if any earlier response from this method exists with a session_id in its output

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "videodb director": {
            "videodb-director": {
                "command": "uvx",
                "args": [
                    "videodb-director-mcp@latest"
                ],
                "env": {
                    "VIDEODB_API_KEY": "your-videodb-api-key"
                }
            }
        }
    }
}

McpServers

{
    "videodb-director": {
        "command": "uvx",
        "args": [
            "videodb-director-mcp@latest"
        ],
        "env": {
            "VIDEODB_API_KEY": "your-videodb-api-key"
        }
    }
}

Add the VideoDB Director MCP Server in your favorite Client

Claude Desktop

To configure VideoDB Director MCP server in Claude, you can run the following command ``uvx videodb-director-mcp --install=claude`



You can manually configure the MCP Server by following these steps:

1. Open the

claude_desktop_config.json

 file

   In MacOS/Linux:


   code ~/Library/Application\ Support/Claude/claude_desktop_config.json



   In Windows:


   code $env:AppData\Claude\claude_desktop_config.json



2. Add the VideoDB Director MCP Server inside the

mcpServers

 key:

json
   {
     "mcpServers": {
       "videodb-director": {
         "command": "uvx",
         "args": ["videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
       }
     }
   }



Cursor


To configure VideoDB Director MCP server in Cursor, you can run the following command

`uvx videodb-director-mcp --install=cursor`



You can manually configure the MCP Server by following these steps:

1. Inside Cursor, go to Settings > Cursor Settings
2. Click on MCP
3. Click on Add new Global MCP Server
4. Add the VideoDB Director MCP Server under the

mcpServers

key

json
   {
     "mcpServers": {
       "videodb-director": {
         "command": "uvx",
         "args": ["videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
       }
     }
   }



Install in Claude and Cursor at the same time.

You can configure VideoDB Director MCP server in Claude and Cursor together, by running the following command


uvx videodb-director-mcp --install=all




Install for Claude Code


claude mcp add videodb-director uvx -- videodb-director-mcp --api-key=<VIDEODB_API_KEY>

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

VideoDB Director

About

Explore

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`doc_assistant`

`code_assistant`

`play_video`

`call_director`

Claude Desktop / Cursor

McpServers

Add the VideoDB Director MCP Server in your favorite Client

Claude Desktop

Cursor

Install in Claude and Cursor at the same time.

Install for Claude Code

Videos about VideoDB Director

AWS Agent Toolkit GitHub Repo: AWS MCP Server Architecture Tutorial and Review agent-toolkit-for-aws

Agent Toolkit for AWS Demo - Using aws-data-analytics skills with Claude Code

Introducing Agent Toolkit for AWS

About

Explore

Setting up with Highlight

From the repository

doc_assistant

code_assistant

play_video

call_director

Claude Desktop / Cursor

McpServers

Add the VideoDB Director MCP Server in your favorite Client

Claude Desktop

Cursor

Install in Claude and Cursor at the same time.

Install for Claude Code

Videos about VideoDB Director

AWS Agent Toolkit GitHub Repo: AWS MCP Server Architecture Tutorial and Review agent-toolkit-for-aws

Agent Toolkit for AWS Demo - Using aws-data-analytics skills with Claude Code

Introducing Agent Toolkit for AWS

More like this

Google Maps

Activepieces

BlenderMCP

AWS MCP Servers

`doc_assistant`

`code_assistant`

`play_video`

`call_director`