About VideoDB Director
VideoDB Director is an MCP server for video and media workloads, launched with uvx. It is aimed at developers who want LLMs or AI agents to use VideoDB capabilities from config-driven MCP clients.
Key features
- 01Launches the MCP server with uvx
- 02Requires a VideoDB API key
- 03Configuration for Claude Desktop, Cursor and Claude Code
- 04One-step install option via --install flag
- 05Supports running the latest package version
Use cases
- 01Adding video processing tools to Claude Desktop
- 02Giving Cursor an agent access to media operations
- 03Registering the server in Claude Code from the command line
MCP support
This is an MCP server. The README describes how to register it in MCP clients such as Claude Desktop, Cursor and Claude Code.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 3w ago
This tool takes no parameters.
Details
From the project READMETo add the MCP server in any config driven MCP Client, following is how the commands and arguments will look like
Install uv
We need to install uv first.
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 also visit the installation steps of uv for more details here
Run the MCP Server
You can run the MCP server using uvx using the following command
uvx videodb-director-mcp --api-key=VIDEODB_API_KEY
Add the VideoDB Director MCP Server in your favorite Client
Claude Desktop
To configure VideoDB Director MCP server in Claude, you can run the following command
uvx videodb-director-mcp --install=claude
You can manually configure the MCP Server by following these steps:
-
Open the
claude_desktop_config.jsonfileIn MacOS/Linux:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonIn Windows:
code $env:AppData\Claude\claude_desktop_config.json -
Add the VideoDB Director MCP Server inside the
mcpServerskey:{ "mcpServers": { "videodb-director": { "command": "uvx", "args": ["videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"] } } }
Cursor
To configure VideoDB Director MCP server in Cursor, you can run the following command
uvx videodb-director-mcp --install=cursor
You can manually configure the MCP Server by following these steps:
-
Inside Cursor, go to Settings > Cursor Settings
-
Click on MCP
-
Click on Add new Global MCP Server
-
Add the VideoDB Director MCP Server under the
mcpServerskey{ "mcpServers": { "videodb-director": { "command": "uvx", "args": ["videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"] } } }
Install in Claude and Cursor at the same time.
You can configure VideoDB Director MCP server in Claude and Cursor together, by running the following command
uvx videodb-director-mcp --install=all
Install for Claude Code
claude mcp add videodb-director uvx -- videodb-director-mcp --api-key=<VIDEODB_API_KEY>
Update VideoDB Director 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>
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.