# video-editing-mcp

Wires Video Jungle into your agent so it can pull in a video by URL, search it by meaning, and cut a rough edit without leaving the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 294
- Author: burningion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/burningion/video-editing-mcp
- Updated: 2025-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/video-editing-mcp

## What it does

The server hands the agent a set of Video Jungle tools. `add-video` grabs a file from a URL and queues it for analysis; both audio and visuals get indexed, so later queries can hit spoken words or on-screen content. `search-videos` matches on embeddings and keywords, and `generate-edit-from-videos` or `generate-edit-from-single-video` turns those matches into a rendered cut.

Local editing goes through `edit-locally`, which builds an OpenTimelineIO project and downloads it for you to open in Davinci Resolve Studio. Resolve Studio has to be running before you call that tool. On macOS, searching your Photos library needs `LOAD_PHOTOS_DB=1` set in the environment.

A Video Jungle account and API key are required. The key goes to the server at launch, as in `uv run video-editor-mcp YOURAPIKEY`. Videos and projects are addressed through the `vj://` URI scheme, and search results carry metadata about what appears in a video and when — enough to drive edit generation.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `VJ_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add video-editing-mcp -e VJ_API_KEY=<VJ_API_KEY> -- uvx video-editor-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from video-editor-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add video-editing-mcp --env VJ_API_KEY=<VJ_API_KEY> -- uvx video-editor-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from video-editor-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "video-editing-mcp": {
            "command": "uvx",
            "args": [
                "video-editor-mcp"
            ],
            "env": {
                "VJ_API_KEY": "<VJ_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from video-editor-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "video-editing-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "video-editor-mcp"
            ],
            "env": {
                "VJ_API_KEY": "<VJ_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from video-editor-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VJ_API_KEY=<VJ_API_KEY> video-editing-mcp uvx video-editor-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from video-editor-mcp <command>

## When to use it
- locate every moment a phrase is spoken in a long recording
- cut a rough edit across several source files from search hits
- ingest a video by URL and get it analyzed automatically
- export a timeline as OpenTimelineIO for Davinci Resolve Studio
- search a macOS Photos library by Apple tags

## Example prompts
- Download the video at this URL and name it fly traps
- Search my videos for fly traps

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26559
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9289

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md