Screen Beaver MCP

Drive Screen Beaver from Cursor, Cursor Cloud, or Claude Desktop — directly via MCP tools. No PowerShell scripts, no JSON files on disk.

Default UX: open Screen Beaver desktop → open URL/app → native capture (no OS Share picker) → short demo (~10–12s) with clicks + key-by-key typing → auto captions/zooms in one recipe → user clicks Export.

Install (published)

npx -y screen-beaver-mcp

Cursor / Claude MCP config:

{
  "mcpServers": {
    "screen-beaver": {
      "command": "npx",
      "args": ["-y", "screen-beaver-mcp"]
    }
  }
}

Requires Screen Beaver desktop open (bridge http://127.0.0.1:17355).

Quick start (monorepo)

npm run mcp:install
npm run mcp:build
npm run desktop:dev

Cursor loads the server from .cursor/mcp.json (stdio via npm.cmd + ${workspaceFolder}/mcp). After install or config changes: enable screen-beaver under Customize → MCPs, then reload Cursor / open a new agent chat.

Skill: .cursor/skills/screen-weaver-demo/SKILL.md

Prompt example

Open my product in Chrome, record a short launch video without me clicking share, auto-build captions. I’ll export myself.

Use MCP tool record_and_build, or step through with demo_move / demo_click / demo_type / demo_scroll.

Capture tools

| Tool | Purpose | |------|---------| | list_capture_targets | Windows + monitors | | open_url / open_path | Launch browser or safe app/document | | start_capture | Native record by id/title (no picker) | | stop_capture | Stop + import take (window or Android) | | android_ensure_runtime | Download portable ADB/scrcpy if needed | | android_list_devices | USB/network Android devices | | android_start / android_stop | Mirror + record phone / import take | | record_and_build | Open → short record → auto edit | | record_android_and_build | Phone: start → demo → stop → auto edit |

Phone needs USB debugging + Allow on the device. First Android run may download ~11 MB into app data.

Direct demo control (no scripts)

| Tool | Purpose | |------|---------| | demo_move | Smooth cursor in captured window | | demo_click | Click (optional move-to) | | demo_type | Type key-by-key (not paste) | | demo_scroll | Wheel | | demo_focus | Foreground capture window | | demo_wait | Pause between beats (max 8s) | | run_demo | Batch steps inline in the tool call |

Edit tools

live_build_demo (autoMode default), add_caption, add_zoom, add_effect, ready_for_export

Reliability notes

• Tools use hard HTTP timeouts so the agent does not hang forever.
• Prefer short demoSteps and maxCaptureSec: 12.
• autoMode applies captions/zooms via one apply_recipe (plus auto-zooms from clicks).

Publish

See root PUBLISHING.md. Build with npm run build in this folder before publish.

Security / Socket: the published tarball has no runtime dependencies (SDK + zod are bundled). Local installs use Socket Registry overrides for leaf packages.