Boson Video MCP server

Boson-Video

Get the point of any video without watching all of it. Paste a YouTube link or drop a video file. Every line of the summary, the transcript and the screen text carries the second it came from, and questions are answered from the video and checked against it.

<!-- mcp-name: io.github.linboxin/boson-video -->

• The ribbon: the whole video on one strip (scenes, chapters, most replayed). Hover to see any second's frame and words.
• Summary: sections with their frames; every sentence timed and checked (✓ ? ✗).
• Transcript: the original with English beneath, technical terms explained, on-screen text read in.
• Ask: answers that cite their moments and show the frames, with background kept apart.
• Your own AI: the same document as an MCP plugin for Claude, Cursor, Codex and more.

Built for long talks, lectures and finance videos in a language you half know (Chinese and English today).

In your own AI

One line, nothing else to install (uv runs it):

claude mcp add boson-video -- uvx boson-video mcp

Claude Desktop (claudedesktopconfig.json) or Cursor (.cursor/mcp.json):

{ "mcpServers": { "boson-video": { "command": "uvx", "args": ["boson-video", "mcp"] } } }

Codex (~/.codex/config.toml):

[mcp_servers.boson-video]
command = "uvx"
args = ["boson-video", "mcp"]

Then ask your AI about any YouTube link. It opens the video, reads the transcript, looks at the frames that matter at full resolution, searches, and checks its claims, citing every moment. No keys needed. Everything runs on your computer. Details: docs/plugin.md.

Run the page

uvx boson-video web             # http://127.0.0.1:8770; the first run prints your invite code

Keys make it fuller: INCEPTIONAPIKEY (Mercury writes the summary, the English and the terms) and TYPESAFEAPIKEY (Jev checks every sentence and answers questions). Put them in a .env file in the folder you start from, or in ~/.boson-video/.env; the server warns at start when one is missing. Without them you still get the scenes, the transcript and search. Any OpenAI-compatible model can write instead of Mercury: set BOSONWRITERBASEURL, BOSONWRITERMODEL and BOSONWRITERAPIKEY. Optional and off by default: with OPENAIAPIKEY and BOSONSCREENCHECK=1, a sentence the words can't confirm gets a second look at the frames on screen (OpenAI's Decisions API, about a cent a video).

Tested videos

Measured, one run each unless a range is shown. Mac: M5 MacBook with Apple's transcriber. Windows: a 12-thread laptop with SenseVoice or Parakeet on the CPU. Full tables: docs/measured.md.

Shortened. The full README is on GitHub.