Skip to content
videodb
VideoDB Documentation
  • Pages
    • Welcome to VideoDB Docs
    • Quick Start Guide
      • Video Indexing Guide
      • Semantic Search
      • How Accurate is Your Search?
      • Collections
      • Public Collections
      • Callback Details
      • Ref: Subtitle Styles
      • Language Support
      • Guide: Subtitles
    • Examples and Tutorials
      • Dubbing - Replace Soundtrack with New Audio
      • VideoDB x TwelveLabs: Real-Time Video Understanding
      • Beep curse words in real-time
      • Remove Unwanted Content from videos
      • Instant Clips of Your Favorite Characters
      • Insert Dynamic Ads in real-time
      • Adding Brand Elements with VideoDB
      • Eleven Labs x VideoDB: Adding AI Generated voiceovers to silent footage
      • Elevating Trailers with Automated Narration
      • Add Intro/Outro to Videos
      • Audio overlay + Video + Timeline
      • Building Dynamic Video Streams with VideoDB: Integrating Custom Data and APIs
      • AI Generated Ad Films for Product Videography: Wellsaid, Open AI & VideoDB
      • Fun with Keyword Search
      • AWS Rekognition and VideoDB - Effortlessly Remove Inappropriate Content from Video
      • Overlay a Word-Counter on Video Stream
      • Generate Automated Video Outputs with Text Prompts | DALL-E + ElevenLabs + OpenAI + VideoDB
    • Visual Search and Indexing
      • Scene Extraction Algorithms
      • Custom Annotations
      • Scene-Level Metadata: Smarter Video Search & Retrieval
      • Advanced Visual Search Pipelines
      • Playground for Scene Extractions
      • Deep Dive into Prompt Engineering : Mastering Video Scene Indexing
    • Multimodal Search
      • Multimodal Search: Quickstart
      • Conference Slide Scraper with VideoDB
    • Real‑Time Video Pipeline
      • Automated Traffic Violation Reporter
    • Meeting Recording SDK
    • Generative Media Quickstart
      • Generative Media Pricing
    • AI Video Editing Automation SDK
      • Fit & Position: Aspect Ratio Control
      • Trimming vs Timing: Two Independent Timelines
      • Advanced Clip Control: The Composition Layer
      • Caption & Subtitles: Auto-Generated Speech Synchronization
      • Notebooks
    • Transcoding Quickstart
    • director-light
      Director - Video Agent Framework
      • Agent Creation Playbook
      • How I Built a CRM-integrated Sales Assistant Agent in 1 Hour
      • Make Your Video Sound Studio Quality with Voice Cloning
      • Setup Director Locally
    • github
      Open Source Tools
      • llama
        LlamaIndex VideoDB Retriever
      • PromptClip: Use Power of LLM to Create Clips
      • StreamRAG: Connect ChatGPT to VideoDB
    • zapier
      Zapier Integration
      • Auto-Dub Videos & Save to Google Drive
      • Create & Add Intelligent Video Highlights to Notion
      • Create GenAI Video Engine - Notion Ideas to Youtube
      • Automatically Detect Profanity in Videos with AI - Update on Slack
      • Generate and Store YouTube Video Summaries in Notion
      • Automate Subtitle Generation for Video Libraries
      • Solve customers queries with Video Answers
    • n8n
      N8N Workflows
      • AI-Powered Meeting Intelligence: Recording to Insights Automation
      • AI Powered Dubbing Workflow for Video Content
      • Automate Subtitle Generation for Video Libraries
      • Automate Interview Evaluations with AI
      • Turn Meeting Recordings into Actionable Summaries
      • Auto-Sync Sales Calls to HubSpot CRM with AI
      • Instant Notion Summaries for Your Youtube Playlist
    • mcp
      VideoDB MCP Server
    • Edge of Knowledge
      • Building Intelligent Machines
        • Part 1 - Define Intelligence
        • Part 2 - Observe and Respond
        • Part 3 - Training a Model
      • Society of Machines
        • Society of Machines
        • Autonomy - Do we have the choice?
        • Emergence - An Intelligence of the collective
      • From Language Models to World Models: The Next Frontier in AI
      • The Future Series
      • How VideoDB Solves Complex Visual Analysis Tasks
    • videodb
      Building World's First Video Database
      • Multimedia: From MP3/MP4 to the Future with VideoDB
      • Dynamic Video Streams
      • Why do we need a Video Database Now?
      • What's a Video Database ?
      • Enhancing AI-Driven Multimedia Applications
      • Misalignment of Today's Web
      • Beyond Traditional Video Infrastructure
      • Research Grants
    • Customer Love
    • Team
      • videodb
        Internship: Build the Future of AI-Powered Video Infrastructure
      • Ashutosh Trivedi
        • Playlists
        • Talks - Solving Logical Puzzles with Natural Language Processing - PyCon India 2015
      • Ashish
      • Shivani Desai
      • Gaurav Tyagi
      • Rohit Garg
      • VideoDB Acquires Devzery: Expanding Our AI Infra Stack with Developer-First Testing Automation
videodb
VideoDB Documentation
/
VideoDB MCP Server

VideoDB MCP Server

The VideoDB MCP Server can be installed and used in multiple ways. Follow the steps below to set it up.

Prerequisite: Ensure Python 3.12 or Later is Installed

Before installing the VideoDB MCP Server, verify that Python 3.12 or later is installed on your system.
Check Python version:
python --version
If the version is below 3.12, update Python from the
official website
⁠
.

Install and Configure VideoDB MCP Server

simplest method using uvx

1. Install uv

macOS:
brew install uv
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 visit the complete installation steps for uv
here
⁠
.

2. Automatic Installation for Clients

To automatically add the MCP Server to Claude, Cursor and Claude Code:
Install for Claude only
uvx videodb-director-mcp --install=claude
Install for Cursor only
uvx videodb-director-mcp --install=cursor

Install for both Claude and Cursor
uvx videodb-director-mcp --install=all
Install for Claude Code
claude mcp add videodb-director uvx -- videodb-director-mcp --api-key=<VIDEODB_API_KEY>

3. Update VideoDB MCP package

To ensure you're using the latest version of the MCP server with uvx, start by clearing the cache:
uv cache clean
This command removes any outdated cached packages of videodb-director-mcp, allowing uvx to fetch the most recent version.
If you always want to use the latest version of the MCP server, update your command as follows:
uvx videodb-director-mcp@latest --api-key=<VIDEODB_API_KEY>
This ensures that uvx pulls the latest release every time you run it.

Setup Video

⁠
⁠
⁠


Advanced Methods

⁠

1. Install the VideoDB MCP Server

a. Using pipx

We need to install pipx first.
For macOS:
brew install pipx
pipx ensurepath
For Windows:
python -m pip install --user pipx
python -m pipx ensurepath
You can now run the MCP Server using:
pipx run videodb-director-mcp --api-key=VIDEODB_API_KEY
⁠

b. Install Using pip

Install the package using pip:
pip install videodb-director-mcp
The MCP server can now be started with the following command:
videodb-director-mcp --api-key=VIDEODB_API_KEY

2. Configuring the MCP Server in Clients

⁠

Claude Desktop

a. Open Configuration File
MacOS/Linux:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
code $env:AppData\Claude\claude_desktop_config.json
b. Modify Configuration
Using pipx:
{
"mcpServers": {
"videodb-director": {
"command": "pipx",
"args": ["run", "videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
}
}
}
Using package installed via pip :
{
"mcpServers": {
"videodb-director": {
"command": "videodb-director-mcp",
"args": ["--api-key=<VIDEODB-API-KEY>"]
}
}
}
⁠

Cursor Editor

a. Open MCP Settings
Navigate to Settings > Cursor Settings
Click on MCP
Click on Add new Global MCP Server
b. Add Configuration
Using pipx:
{
"mcpServers": {
"videodb-director": {
"command": "pipx",
"args": ["run", "videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
}
}
}
Using package installed via pip :
{
"mcpServers": {
"videodb-director": {
"command": "videodb-director-mcp",
"args": ["--api-key=<VIDEODB-API-KEY>"]
}
}
}

Claude Code

a. Add configuration
To configure VideoDB Director MCP for Claude code you can run the following command
Using pipx:
claude mcp add videodb-director pipx -- run videodb-director-mcp --api-key=<VIDEODB_API_KEY>
Using package installed via pip :
claude mcp add videodb-director videodb-director-mcp -- --api-key=<VIDEODB_API_KEY>
b. Verify configuration
You can verify if the MCP Server has been added correctly or not by simply running the following command:
claude mcp list

3. Update the VideoDB Director MCP Package

To ensure you're using the latest version of a package installed via pipx or pip, run:
pip install --upgrade videodb-director-mcp
This will upgrade the package to its latest available version.

Prerequisite: Ensure Python 3.12 or Later is Installed
Install and Configure VideoDB MCP Server
1. Install uv
2. Automatic Installation for Clients
3. Update VideoDB MCP package
Setup Video
Advanced Methods
1. Install the VideoDB MCP Server
a. Using pipx
b. Install Using pip
2. Configuring the MCP Server in Clients
Claude Desktop
Cursor Editor
Claude Code
3. Update the VideoDB Director MCP Package
Want to print your doc?
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.