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>"]
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.