mcp-screenshot

MCP server for taking Wayland screenshots via grim/slurp. Part of likezara™ MCP suite.

PyPI

Version: 1.0.1

Weekly downloads: 60

Maintainers: 1

Created: 4 months ago

mcp-screenshot

MCP server for taking Linux / Wayland screenshots via grim and slurp.

Exposes 2 tools to capture the full screen, a selected region, or an interactive crop — returned inline as base64 or saved to disk.

📖 อ่านภาษาไทย →

Tools

Tool	Purpose
`take_screenshot`	Capture screen (full / geometry / interactive select)
`list_outputs`	List available Wayland outputs / monitors

Requirements

Wayland compositor (Sway, Hyprland, etc.)
grim — screenshot tool
slurp — interactive region selector
wlr-randr (optional) — for list_outputs

Install on Arch Linux:

sudo pacman -S grim slurp wlr-randr

Install

claude mcp add screenshot -s user \
  --env WAYLAND_DISPLAY=wayland-1 \
  --env XDG_RUNTIME_DIR=/run/user/1000 \
  -- /path/to/mcp-screenshot/.venv/bin/python /path/to/mcp-screenshot/server.py

Build the venv once:

cd /path/to/mcp-screenshot
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python mcp

Support the project ❤

Ko-fi: https://ko-fi.com/kamaru

Contact

Portfolio / general: k.kamarux@gmail.com
Commercial / licensing: contact@likezara.com

Keywords

FAQs

What is mcp-screenshot?

Is mcp-screenshot well maintained?

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install