Back to Browse

Screenshot MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (5/5 approved).

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: WAYLAND_DISPLAY

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

Environment variable: XDG_RUNTIME_DIR

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-kamarusama-mcp-screenshot": {
      "env": {
        "WAYLAND_DISPLAY": "your-wayland-display-here",
        "XDG_RUNTIME_DIR": "your-xdg-runtime-dir-here"
      },
      "args": [
        "mcp-screenshot"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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).

Reviews

No reviews yet

Be the first to review this server!