Video Frames MCP Server

An MCP server that lets image-only models look at video: frames with timecodes, plus measurable video properties. It runs locally over stdio via the published package.

People connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-28 · ★ 2 · #183 OF 193 MAINTAINED MEDIA · VERIFIED 2026-09-30

MIT · Python servers · how we verify → /methodology

01 · Install Video Frames

Claude Code

claude mcp add azzy-h-mcp-video-frames -- uvx mcp-video-frames

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "azzy-h-mcp-video-frames": {
      "command": "uvx",
      "args": [
        "mcp-video-frames"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-09-24 - young repo, little track record yet

license MIT - declared in the repository

pypi package mcp-video-frames - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Azzy-H is GitHub-verified and matches the repo owner

03 · What Video Frames can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 2 documented tools across read & search, video, including view_frames, video_info.

The 2 tools it gives your agent

Extracted from the project's README - what Video Frames lets an agent do.

view_frames
- Sample a time range and return frames as images, each preceded by its timecode
video_info
- Container metadata, optionally with a whole-file scene/silence/loudness scan

Latest releases

v0.1.1 · 2026-09-28

Metadata-only release. Nothing about how the server behaves has changed - if · you already have 0.1.0 installed, there is nothing here you need. This version · exists because a PyPI version number can never be reused…

v0.1.0 · 2026-09-28

First release. An MCP server that gives models without video input a way to · look at video: frames with timecodes, plus measurable properties of the file. · Install · sh · pip install mcp-video-frames # or run it…

04 · Who maintains Video Frames

Video Frames is maintained by azzy-h. It's the only MCP server we track from this author; the repo dates to Sep 2026.

05 · Facts

category
media - ranked #183 of 193 actively-maintained media servers as of 2026-09-30.
release cadence
2 releases in the last 90 days (latest 2026-09-28)
registry
io.github.Azzy-H/mcp-video-frames (active, first published 2026-09-28)
packages
pypi:mcp-video-frames

06 · Video Frames FAQ

What is Video Frames?

An MCP server that lets image-only models look at video: frames with timecodes, plus measurable video properties. It runs locally over stdio via the published package.

Is Video Frames still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-28 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install Video Frames?

Run `uvx mcp-video-frames`. You can also paste the ready-made client config above.

Does Video Frames run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Video Frames