Video Reader MCP

io.github.SylphxAIPublished by GitHub account SylphxAIv0.1.0Updated Oct 24, 2026

Evidence-first video MCP. Timeline document with ffprobe streams and subtitle cues.

VerifiedSTDIODesktop onlyFiles & StorageMedia & Design

Overview

AI-generated overview

Local MCP server that gives an assistant a searchable, timestamped timeline of local video files, with frame evidence on request.

What you can do
  • Read a local video's container metadata, streams, chapters and embedded subtitles, optionally adding ffmpeg scene detection with the quality profile
  • Search embedded subtitle cues for a quote and get timestamped matches
  • Render, crop or OCR a single frame at a known timestamp as follow-up evidence
  • Report missing ffprobe or subtitles as explicit gaps rather than guessing
When to use it
Useful when an assistant needs to answer questions about local video files — finding a quote, summarizing a meeting by chapters, locating a moment in a demo — and every answer should cite a timestamp, stream index or source hash. Not suited to videos without embedded subtitles or to speech-to-text needs.
Requirements
Runs as a local stdio process, typically launched with npx from the npm package; ffprobe must be available for metadata, and videos need embedded subtitles for quote search. No authentication, environment variables or headers are declared. The repository is archived and the README says the project was merged into a different package.
Before you install
The README states the repository is archived and points to a successor package, so check maintenance before installing. Speech recognition, keyframes and transcripts are not performed: enabling include_keyframes or include_transcript returns a warning and an empty array. Frame rendering and OCR run locally on the files you point it at.

Installation

In SourceWeft

  1. Open Video Reader MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Merged into anymd (2026-09-25). anymd reads PDFs, Office files, EPUB, web pages, images and video into clean Markdown for AI agents: npx -y @sylphx/anymd. This repository is archived.

Cue

Video answers with timestamp-level proof

Cue gives agents a local video timeline they can search and cite. The default read returns container metadata, streams, chapters, and embedded subtitles. Scenes and frames are separate.

bash
npx -y @sylphx/cue

For Claude Code:

bash
claude mcp add cue -- npx -y @sylphx/cue

Read a local video

json
{  "sources": [{ "path": "/absolute/path/to/demo.mp4" }]}

That call uses the fast profile. It returns container metadata, streams, chapters, and embedded subtitles. It does not detect scenes, extract frames, or run speech recognition.

Then ask:

“Which chapter covers the pricing change?”

Cue returns chapter and subtitle locators with timestamp_ms and the source hash. It does not invent a transcript. A quote search matches embedded subtitles only. Render or crop a frame afterwards with video_evidence, once you have a timestamp.

Jobs Cue is built for

Ask your agentCue returns
“Find this quote.”a timestamped match in embedded subtitles, when those subtitles exist
“Summarize this meeting.”chapters and embedded subtitles
“Where is the code shown?”one frame from video_evidence at a known timestamp
“What changed in this demo?”scene boundaries when profile is quality or include_scenes is set
“Give me the useful moments.”chapters, embedded subtitles, warnings, and gaps

Tool surface

ToolPurpose
read_videoDefault fast profile: container metadata, streams, chapters, and embedded subtitles. Scenes are opt-in.
search_videoSearch embedded subtitle cues. It does not run speech recognition.
video_evidenceNamed follow-up: render, crop, or OCR one frame at a timestamp

Predictable defaults

  • Omitted profile is fast: container metadata, streams, chapters, and embedded subtitles. No scenes, frames, or speech recognition.
  • profile quality adds ffmpeg scene detection. It does not extract frames or run speech recognition.
  • include_keyframes and include_transcript stay off. Setting either one on the shipped server returns a warning and an empty array.
  • OCR stays on video_evidence.
  • No cloud video API or frame-by-frame vision model is required.
  • Missing ffprobe or embedded subtitles is reported as a gap, not guessed around.

Why agents trust it

Every claim can point back to timestamp_ms, a stream index, a subtitle range, or the source hash. A frame index is present only after video_evidence.

Companion MCP tools

ProductJob
CitraPDF answers with page-level proof
IrisImage facts and pixel evidence
SpineRepository architecture and impact
LocusExact code-chunk retrieval
LookoutWeb research with source excerpts

Each product is independent. Install only the tools your agent needs.

Development

bash
bun installbun run buildbun testcargo testbun run benchmark:public-proofbun run benchmark:release-gate

License

MIT

Source: README.md at commit 30773b7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts