screenshot-mcp
MCP server for capturing screenshots of desktop windows on Windows. Allows AI assistants to see what's on screen — useful for UI development, debugging visual issues, and iterating on designs.
Features
- screenshot_window — capture a specific window by title (partial match)
- screenshot_screen — capture the entire screen
- screenshot_region — capture a specific screen region (x, y, width, height)
- click_window — click at a position inside a window's client area
- get_window_size — get the client area size of a window
- list_windows — list all visible windows with titles and sizes
Returns images as base64-encoded JPEG with automatic resizing and compression.
Requirements
- Windows 10/11
- Python 3.10+
Installation
pip install screenshot-mcpOr install from source: ``bash git clone https://github.com/ibuildrun/screenshot-mcp.git cd screenshot-mcp pip install -e . ``
MCP Configuration
Add to your .kiro/settings/mcp.json:
{
"mcpServers": {
"screenshot": {
"command": "screenshot-mcp",
"disabled": false
}
}
}Or with uvx (no install needed): ``json { "mcpServers": { "screenshot": { "command": "uvx", "args": ["screenshot-mcp"], "disabled": false } } } ``
Usage Examples
> list_windows
> screenshot_window "Teeworlds"
> screenshot_screen
> screenshot_region 0 0 800 600
> click_window "Teeworlds" 400 300
> get_window_size "Teeworlds"License
MIT
