markuprx: an open-source MCP server that turns narrated screen captures into one issue per annotation

TitleNo1715 · reddit · 2026-09-04

The author open-sourced markuprx, an MIT-licensed, fully local MCP server solving a real gap: agents see the repo but not your screen.

Key design: instead of handing the model one big recording blob, each modifier-key circle gesture while you narrate becomes its own issue (MX-001) with a cropped frame and the matching narration slice — circle three problems, get three independently actionable issues.

Pipeline: native macOS capture → local Whisper → heuristic pass to find moments you're describing something → ffmpeg frame extraction → timestamp-aligned structured Markdown. No Electron; cloud transcription only with your own key (screen recordings may capture sensitive content). Config is one npx --package markuprx markuprx-mcp entry; six tools cover screenshots, voice capture, video analysis, and recording.

Honest limitations: narration-to-mark alignment is heuristic (rambling after circling can mis-attach words), and pixel-pinned findings break on layout shifts — stable selectors/text anchors suggested but not built yet.

Original post →

More from coding & agent

coding & agent channel →