Screencast MCP Server

What the code does

We read the source, 2 d ago · rules 995398eba69f

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

          writeFileSync(meta, ffmetadata(chapters));

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

const grab = spawn(cfg.ffmpeg, buildWgcGrabArgs(cfg.hwnd, cfg.fps, cfg.cursor !== false), { stdio: ["ignore", "pipe", "pipe"], windowsHide: true });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add screencast-mcp -- npx -y @tmhs/screencast-mcp

{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}

[mcp_servers.screencast-mcp]
command = "npx"
args = ["-y", "@tmhs/screencast-mcp"]

{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}

{
  "servers": {
    "screencast-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: SCREENCAST_HOME (Where recordings, frames, screenshots, and edits are written (default <homedir>/.screencast-mcp)), SCREENCAST_ALLOWED_DIRS (Semicolon-separated folders tools may read from and write to besides SCREENCAST_HOME; when set (or when the client sends roots), files elsewhere are refused. Also allows overwriting files in these folders), FFMPEG_PATH (Path to ffmpeg if it is not on PATH (ffmpeg and ffprobe are required)), FFPROBE_PATH (Path to ffprobe if it is not on PATH), SCREENCAST_WHISPER_MODEL (whisper.cpp model file (ggml-*.bin) used by transcribe when a call passes no model), SCREENCAST_MAX_RECORDING_SEC (Default recording cap in seconds when a call sets no maxDurationSec (default 3600; 0 disables it)), SCREENCAST_JOB_TIMEOUT_MS (Override the edit job timeout in milliseconds (default scales with the media length)), SCREENCAST_RETENTION_DAYS (At startup, delete screenshots, frames, and leftover raw event logs older than this many days (never recordings or edits; off by default)), SCREENCAST_PS_TIMEOUT_MS (Limit in milliseconds for the PowerShell helpers that list monitors and windows and run OCR (default 20000; OCR 60000)), SCREENCAST_CONFIRM_CAPTURE (Set to 1 to ask the user to confirm every live capture through MCP elicitation; clients without elicitation are refused (off by default)), SCREENCAST_TOOLSETS (Comma-separated toolsets to load: capture, watch, edit, produce, audio (doctor and get_media_info are always on; default all)).