mcpField
M
mcp-screenshot

mcp-screenshot

Local
github.com/KamaruSamaMedia & Design0Updated 28w ago
Repository

About mcp-screenshot

mcp-screenshot is an MCP server for capturing screens on Linux Wayland systems using grim and slurp. It supports full-screen, region, and interactive captures, with images returned inline or saved to disk.

Key features

  1. 01Capture the full screen
  2. 02Capture a specified region
  3. 03Select a crop interactively
  4. 04Return images inline as base64
  5. 05Save captures to disk
  6. 06List Wayland outputs

Use cases

  1. 01Capture a full desktop image
  2. 02Save a selected screen region
  3. 03Choose a crop interactively

MCP support

Exposes two tools to MCP clients: taking screenshots and listing available Wayland outputs or monitors.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "kamarusama-mcp-screenshot": {
      "command": "uvx",
      "args": [
        "mcp-screenshot"
      ],
      "env": {
        "WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
        "XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>"
      }
    }
  }
}
Run commanduvx mcp-screenshot
Environment variables to set
WAYLAND_DISPLAYWayland display identifier (e.g. wayland-1). Required for grim to find the compositor.
XDG_RUNTIME_DIRWayland runtime directory (e.g. /run/user/1000). Required for socket lookup.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-screenshot1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

ToolPurpose
take_screenshotCapture screen (full / geometry / interactive select)
list_outputsList 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 ❤

Contact

Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.