io.github.KamaruSama/mcp-screenshot
Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
mcp-screenshotclaude mcp add mcp-screenshot -e 'WAYLAND_DISPLAY=<WAYLAND_DISPLAY>' -e 'XDG_RUNTIME_DIR=<XDG_RUNTIME_DIR>' -- uvx mcp-screenshot==1.0.1
{
"mcpServers": {
"mcp-screenshot": {
"command": "uvx",
"args": [
"mcp-screenshot==1.0.1"
],
"env": {
"WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
"XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>"
}
}
}
}
Variables d'environnement
WAYLAND_DISPLAYobligatoire Wayland display identifier (e.g. wayland-1). Required for grim to find the compositor.XDG_RUNTIME_DIRobligatoire Wayland runtime directory (e.g. /run/user/1000). Required for socket lookup.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent 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 toolslurp— interactive region selectorwlr-randr(optional) — forlist_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
Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).
Questions fréquentes
Qu'est-ce que io.github.KamaruSama/mcp-screenshot ?
Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.
Comment installer io.github.KamaruSama/mcp-screenshot ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.KamaruSama/mcp-screenshot ?
Oui. Il attend WAYLAND_DISPLAY, XDG_RUNTIME_DIR, à renseigner dans sa configuration.
io.github.KamaruSama/mcp-screenshot est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.KamaruSama/mcp-screenshot ?
Il est publié par KamaruSama. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.