Skip to main content

​
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

​
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
  1. Navigate to Settings > Cursor Settings
  2. Click on MCP
  3. 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.