Mcp Screenshot
by KamaruSamacommunityv1.0.1
The MCP ACS Screenshot Server enables AI agents to capture, analyze, and document user interfaces visually, enhancing their capabilities beyond code-only interactions.
From the registry: Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.
Install & configure
Prerequisites
- requiredNode.js 18+Required runtime
- requiredInstall system screenshot toolsLinux: imagemagick (X11) or grim (Wayland). macOS: built-in screencapture + Screen Recording permission. Windows: none.
- requiredInstall the packageInstall @ai-capabilities-suite/mcp-screenshot
https://www.npmjs.com/package/@ai-capabilities-suite/mcp-screenshot$ npm install @ai-capabilities-suite/mcp-screenshot
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-screenshot` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Node.js 18+** — Required runtime
- **Install system screenshot tools** — Linux: imagemagick (X11) or grim (Wayland). macOS: built-in screencapture + Screen Recording permission. Windows: none.
- **Install the package** — Install @ai-capabilities-suite/mcp-screenshot Run: `npm install @ai-capabilities-suite/mcp-screenshot` (https://www.npmjs.com/package/@ai-capabilities-suite/mcp-screenshot)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@ai-capabilities-suite/mcp-screenshot"]
- optional environment variables:
- `SCREENSHOT_ALLOWED_DIRS`: Comma-separated list of allowed save directories (example: `/home/user/screenshots,/tmp`)
- `SCREENSHOT_MAX_CAPTURES_PER_MIN`: Rate limit on captures (example: `60`)
- `SCREENSHOT_ENABLE_AUDIT_LOG`: Enable audit logging (example: `true`)
- `SCREENSHOT_BLOCKED_WINDOWS`: Window title patterns to exclude from capture (example: `.*Password.*`)
Note: README shows running via node path to dist/cli.js; canonical npm install gives access via the published package.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: README shows running via node path to dist/cli.js; canonical npm install gives access via the published package.
Tools (5)
screenshot_capture_full
Captures the full screen or a specific display.
screenshot_capture_window
Captures a specific application window by ID or title pattern.
screenshot_capture_region
Captures a specific rectangular region of the screen.
screenshot_list_displays
Lists all connected displays with resolution and position information.
screenshot_list_windows
Lists all visible windows with title, process, and position information.
Environment variables
SCREENSHOT_ALLOWED_DIRSrequiredComma-separated list of allowed directories for saving screenshots.SCREENSHOT_MAX_CAPTURES_PER_MINrequiredMaximum captures per minute.SCREENSHOT_ENABLE_AUDIT_LOGrequiredEnable audit logging.Packages
mcp-screenshot
pypiv1.0.1transport: stdio
Details
- Language
- Python
- License
- NOASSERTION
- Released
- Apr 19, 2026
- Last commit
- Apr 19, 2026
- Registry name
- io.github.KamaruSama/mcp-screenshot