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-mcp

Or install from source:

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):

{
  "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