mcpbeat Sign in

shotbox MCP Server

local only

shotbox runs on your own machine — the client starts it, so there is no endpoint to ping. 205 installs a week from pypi. Last commit 2 Nov 2026.

Sealed X11/Wayland sessions to see, drive and check real GUI programs: a11y, pictures, sound.

Installs per day peak 739 · avg 152 · -83% w/w
a month agotoday
205
Installs / week
pypi · shotbox
1
Stars
30 open issues
2 Nov 2026
Last commit
from GitHub
MIT
License
Python

What the code does

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

A tool parameter reaches a dangerous call

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.

A tool parameter reaches a dangerous call record.path → shotbox/mcp.py:395, record.path → shotbox/mcp.py:398, start_session.a11y → shotbox/screen.py:702 и ещё 17
            length = float(subprocess.run(
Capabilities

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.

Runs an external command node/gif.mjs:38, node/launch.mjs:30
        const child = spawn(cmd, args, { stdio: ['ignore', 'ignore', 'pipe'] });
    out = subprocess.run(["xauth", "-f", xauthority, "list", display],
            path = os.path.join(cwd, program)
Dumps the whole environment [пакет] shotbox/screen.py:78, shotbox/screen.py:79
        self.env = dict(os.environ if env is None else env)

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

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

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.

run in your terminal
claude mcp add shotbox -- uvx shotbox
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "shotbox": {
      "command": "uvx",
      "args": [
        "shotbox"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.shotbox]
command = "uvx"
args = ["shotbox"]
.cursor/mcp.json
{
  "mcpServers": {
    "shotbox": {
      "command": "uvx",
      "args": [
        "shotbox"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "shotbox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shotbox"
      ]
    }
  }
}

Alternatives to shotbox

same job, measured the same way
Termmux
by cloudcorprecords

Drive local tmux sessions, windows and panes: list, create, send keys, capture output.

local only
tmux
by libtmux

Drive one tmux server: sessions, windows, panes, and the output they produce.

local only
FL Studio Agent
by origami-research

Drive FL Studio from an AI agent: write notes, set tempo and levels, check what sounds, render.

2 120 installs/wk local only
Cowork QA
by insideos-designs

Goal-driven Playwright browser sessions for LLMs, with full action traces and aria-snapshots.

44 installs/wk local only
Claude Wrap MCP
by alex-kaff

MCP server that spawns and drives Claude Code sessions via claude-wrap.

59 installs/wk local only
CXT Software MCP by usefulapi
by usefulapi

Track and search CXT courier orders, check drivers, propose and save order and route plans.

14 tools answering
Google Workspace
by proscendia

Permissioned access to Gmail, Drive and Calendar via the user's own Google account

answering
Chromeflow
by chromeflow

Lets Claude Code or Codex CLI drive your real Chrome — sessions intact, 28 browser tools.

local only

shotbox — questions

Answers built from our own checks of this server.

Why is there no uptime for shotbox?
shotbox runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package shotbox was installed 205 times last week.
How do I connect shotbox?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls shotbox straight from pypi; nothing to host, nothing to sign up for.
How many people use shotbox?
The pypi package shotbox was installed 205 times in the last week. Week over week that is -83%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is shotbox open source?
Yes — it is published under the MIT licence, written in Python, 1 stars on GitHub and 30 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.