Video Vision MCP Server

by kitdevuaio.github.KitDevUA/video-vision-mcpv0.5.1

Analyze any video (local file or URL) into frames + transcript for Claude Code

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Video Vision MCP server

claude mcp add video-vision -e GEMINI_API_KEY='<gemini-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e GROQ_API_KEY='<groq-api-key>' -- uvx video-vision-mcp

{
  "mcpServers": {
    "video-vision": {
      "command": "uvx",
      "args": [
        "video-vision-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "video-vision": {
      "command": "uvx",
      "args": [
        "video-vision-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "video-vision": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "video-vision-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "video-vision": {
      "command": "uvx",
      "args": [
        "video-vision-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "OPENAI_API_KEY": "<openai-api-key>",
        "GROQ_API_KEY": "<groq-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VIDEO_MCP_ENV	—	—	Optional path to a .env file with config (API keys, tuning).
GEMINI_API_KEY	—	yes	Enables tier-3 native Gemini video analysis (default when set).
OPENAI_API_KEY	—	yes	Enables tier-2 OpenAI Whisper transcription.
GROQ_API_KEY	—	yes	Enables tier-2 Groq whisper-large-v3 transcription.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-06 · 2mo ago · GitHub
Latest release
2026-08-06 · 2mo ago · GitHub · v0.5.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-06 · 2mo ago · official registry · v0.5.1

FAQ

›How do I install the Video Vision MCP server in Claude Code?

Run: claude mcp add video-vision -e GEMINI_API_KEY='<gemini-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e GROQ_API_KEY='<groq-api-key>' -- uvx video-vision-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Video Vision require an API key?

Yes. It expects GEMINI_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, of which 3 are secrets.

›Can I use Video Vision as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Video Vision in the official MCP registry?

Yes, as io.github.KitDevUA/video-vision-mcp.