videodb_mcp_server_109.txt•8.01 kB
# VideoDB MCP Server [Source Link](https://docs.videodb.io/videodb-mcp-server-109)
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
*   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
*   Meeting Recording Agent Quickstart
*   How VideoDB Solves Complex Visual Analysis Tasks
*   Generative Media Quickstart
*   Generative Media Pricing
*   Dynamic Video Streams
*   Ref: TextAsset
*   Guide : TextAsset
*   VideoDB MCP Server
*   Transcoding Quickstart
*   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
*   Open Source Tools
*   LlamaIndex VideoDB Retriever
*   PromptClip: Use Power of LLM to Create Clips
*   StreamRAG: Connect ChatGPT to VideoDB
*   Examples and Tutorials
*   Dubbing - Replace Soundtrack with New Audio
*   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
*   Revolutionize Video Editing with VideoDb: Effortless Ad Placement and Seamless Video Integration
*   Eleven Labs x VideoDB: Adding AI Generated voiceovers to silent footage
*   Elevating Trailers with Automated Narration
*   Add Intro/Outro to Videos
*   Enhancing Video Captions with VideoDB Subtitle Styling
*   Audio overlay + Video + Timeline
*   Building Dynamic Video Streams with VideoDB: Integrating Custom Data and APIs
*   Adding AI Generated Voiceovers with VideoDB and LOVO
*   AI Generated Ad Films for Product Videography: Wellsaid, Open AI & VideoDB
*   Fun with Keyword Search
*   AWS Rekognition and VideoDB - Intelligent Video Clips
*   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
*   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
*   Drafts
*   From Language Models to World Models: The Next Frontier in AI
*   The Future Series
*   Building World's First Video Database
*   Multimedia: From MP3/MP4 to the Future with VideoDB
*   Introducing VideoDB: The Pinnacle of Synchronized Video Streaming for the Modern Web
*   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
*   Team
*   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
*   Customer Love
*   Temp Doc
# 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](https://www.python.org/downloads/).
# 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](https://astral.sh/uv).
## 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.
# 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:
```json
{
    "mcpServers":{
        "videodb-director":{
            "command":"pipx",
            "args":["run","videodb-director-mcp","--api-key=<VIDEODB-API-KEY>"]
        }
    }
}
```
Using package installed via pip :
```json
{
    "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:
```json
{
    "mcpServers":{
        "videodb-director":{
            "command":"pipx",
            "args":["run","videodb-director-mcp","--api-key=<VIDEODB-API-KEY>"]
        }
    }
}
```
Using package installed via pip :
```json
{
    "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.
---