> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videodb.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

* **Check Python version:**

```bash theme={null}
python --version
```

* If the version is below 3.12, update Python from the [official website](https://www.python.org/downloads/).

# Install and Configure VideoDB MCP Server

> simplest method using `uvx`

## 1. Install `uv`

**macOS:**

```bash theme={null}
brew install uv
```

**For macOS/Linux:**

```bash theme={null}
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**For Windows:**

```bash theme={null}
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

You can visit the complete installation steps for uv [here](https://astral.sh/uv).

## 2. Automatic Installation for Clients

To automatically add the MCP Server to Claude, Cursor and Claude Code:

**Install for Claude only**

```bash theme={null}
uvx videodb-director-mcp --install=claude
```

**Install for Cursor only**

```bash theme={null}
uvx videodb-director-mcp --install=cursor

```

**Install for both Claude and Cursor**

```bash theme={null}
uvx videodb-director-mcp --install=all
```

**Install for Claude Code**

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/E7y3jRCz2YM" title="VideoDB MCP Server Setup" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

# Alternative Methods

## 1. Install the VideoDB MCP Server

### a. Using `pipx`

We need to install `pipx` first.

**For macOS:**

```bash theme={null}
brew install pipx
pipx ensurepath
```

**For Windows:**

```bash theme={null}
python -m pip install --user pipx
python -m pipx ensurepath
```

You can now run the MCP Server using:

```bash theme={null}
pipx run videodb-director-mcp --api-key=VIDEODB_API_KEY
```

### b. Install Using `pip`

Install the package using pip:

```bash theme={null}
pip install videodb-director-mcp
```

The MCP server can now be started with the following command:

```bash theme={null}
videodb-director-mcp --api-key=VIDEODB_API_KEY
```

## 2. Configuring the MCP Server in Clients

### Claude Desktop

**a. Open Configuration File**

* **MacOS/Linux:**

```bash theme={null}
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

* **Windows:**

```bash theme={null}
code $env:AppData\Claude\claude_desktop_config.json
```

**b. Modify Configuration**

**Using `pipx`:**

```json theme={null}
{
  "mcpServers": {
    "videodb-director": {
      "command": "pipx",
      "args": ["run", "videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
    }
  }
}
```

**Using package installed via `pip`:**

```json theme={null}
{
  "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`:**

```json theme={null}
{
  "mcpServers": {
    "videodb-director": {
      "command": "pipx",
      "args": ["run", "videodb-director-mcp", "--api-key=<VIDEODB-API-KEY>"]
    }
  }
}
```

**Using package installed via `pip`:**

```json theme={null}
{
  "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`:**

```bash theme={null}
claude mcp add videodb-director pipx -- run videodb-director-mcp --api-key=<VIDEODB_API_KEY>
```

**Using package installed via `pip`:**

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
pip install --upgrade videodb-director-mcp
```

This will upgrade the package to its latest available version.