io.github.KamaruSama/mcp-screenshot

Official

by KamaruSama · Python

Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.

Captures Wayland screenshots with full screen, region, or interactive crop options.

Topics

anthropicclaudeclaude-codelikezaramcpmcp-servermodel-context-protocol

README.md1 KBView on GitHub

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:

bash

sudo pacman -S grim slurp wlr-randr

Install

bash

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:

bash

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

Install

Configuration

Environment variables

WAYLAND_DISPLAYrequired

Wayland display identifier (e.g. wayland-1). Required for grim to find the compositor.

XDG_RUNTIME_DIRrequired

Wayland runtime directory (e.g. /run/user/1000). Required for socket lookup.

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-screenshot": {
      "command": "uvx",
      "args": [
        "mcp-screenshot"
      ],
      "env": {
        "WAYLAND_DISPLAY": "<YOUR_WAYLAND_DISPLAY>",
        "XDG_RUNTIME_DIR": "<YOUR_XDG_RUNTIME_DIR>"
      }
    }
  }
}