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

Alternative 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.

Start Here

Core Concepts

Ingest

Understand

Act

Automate

Open Source Frameworks

MCP Server

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

Alternative 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

​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

​Alternative 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

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

Alternative 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