# claude-real-video

Processes video locally into key frames and a transcript so an agent can answer questions about the recording. Works with URLs and local files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2259
- Author: HUANGCHIHHUNGLeo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HUANGCHIHHUNGLeo/claude-real-video
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/claude-real-video

## What it does

claude-real-video runs an MCP server locally and accepts a video URL or file path. It selects frames around scene changes, removes near-duplicates, transcribes the audio, and writes an output folder with frames, timestamps, a transcript, and `MANIFEST.txt`.

An agent can use those files to answer questions about the video. The package also includes the local `crv-web` page and a `--viewer` option for inspecting frames and the transcript. Use `--from` and `--to` for a time range, `--adaptive` for gradual changes, or `--text-anchors` for subtitle-timed frames. The Claude Code setup runs the server through `uvx`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add claude-real-video -- uvx claude-real-video
```
uvx runs the command named after the package; if the README names another one, use uvx --from claude-real-video <command>

### Codex

**Platform CLI**
```bash
codex mcp add claude-real-video -- uvx claude-real-video
```
uvx runs the command named after the package; if the README names another one, use uvx --from claude-real-video <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "claude-real-video": {
            "command": "uvx",
            "args": [
                "claude-real-video"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from claude-real-video <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "claude-real-video": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "claude-real-video"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from claude-real-video <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add claude-real-video uvx claude-real-video
```
uvx runs the command named after the package; if the README names another one, use uvx --from claude-real-video <command>

## When to use it
- inspect a video by key scene
- create a transcript with timestamps
- ask questions about a local video
- limit analysis to a time range
- review extracted frames in a local viewer

## Example prompts
- Watch this video and list its key scenes with timestamps.
- Analyze this video file and find the moment where the requested screen appears.
- Process the section with `--from 28:00 --to 43:00`, then answer from the frames and transcript.

## Similar
- [Video Processor](https://affpapa.org/en/nevibecode/skills/video-processor.md) — skill · ★ 1554
- [video-understand](https://affpapa.org/en/nevibecode/skills/video-understand.md) — skill · 1400 installs
- [video-summarizer](https://affpapa.org/en/nevibecode/skills/video-summarizer.md) — skill · 524 installs
- [automate-this](https://affpapa.org/en/nevibecode/skills/automate-this.md) — skill · 2300 installs
- [ai-video-generation](https://affpapa.org/en/nevibecode/skills/prime-skills-ai-video-generation.md) — skill · 383000 installs
- [video](https://affpapa.org/en/nevibecode/skills/starchild-ai-agent-video.md) — skill · 2700 installs

From the same set: [huangchihhungleo/claude-real-video](https://affpapa.org/en/nevibecode/by/huangchihhungleo/claude-real-video.md) — 3 cards

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