English Français العربية

io.github.KamaruSama/mcp-screenshot

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package mcp-screenshot
Claude Code 
claude mcp add mcp-screenshot -e 'WAYLAND_DISPLAY=<WAYLAND_DISPLAY>' -e 'XDG_RUNTIME_DIR=<XDG_RUNTIME_DIR>' -- uvx mcp-screenshot==1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-screenshot": {
            "command": "uvx",
            "args": [
                "mcp-screenshot==1.0.1"
            ],
            "env": {
                "WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
                "XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>"
            }
        }
    }
}

متغيرات البيئة

  • WAYLAND_DISPLAY إلزامي Wayland display identifier (e.g. wayland-1). Required for grim to find the compositor.
  • XDG_RUNTIME_DIR إلزامي Wayland runtime directory (e.g. /run/user/1000). Required for socket lookup.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. mcp-screenshot
  2. Tools
  3. Requirements
  4. Install
  5. Support the project ❤
  6. Contact

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

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

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

الأسئلة الشائعة

ما هو io.github.KamaruSama/mcp-screenshot؟

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

كيف أثبّت io.github.KamaruSama/mcp-screenshot؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-screenshot -e 'WAYLAND_DISPLAY=<WAYLAND_DISPLAY>' -e 'XDG_RUNTIME_DIR=<XDG_RUNTIME_DIR>' -- uvx mcp-screenshot==1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.KamaruSama/mcp-screenshot إلى مفتاح API؟

نعم. يتطلب WAYLAND_DISPLAY, XDG_RUNTIME_DIR، وتضبطها في إعداداته.

هل io.github.KamaruSama/mcp-screenshot مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.KamaruSama/mcp-screenshot؟

ينشره KamaruSama. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.