VideoDB Documentation
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.
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"
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
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
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
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.
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.