screenshot-mcp 0.1.3

A Model Context Protocol (MCP) server for taking cross-platform screenshots of windows, monitors, and processes.
screenshot-mcp-0.1.3 is not a library.

screenshot-mcp

A robust Model Context Protocol (MCP) server written in Rust that enables Large Language Models (LLMs) to natively take screenshots across operating systems (Linux, Windows, macOS).

Exposes two tools:

  • list_screenshot_targets: Get information about all active monitors and windows, including their IDs, process names, and window titles.
  • take_screenshot: Takes the screenshot and returns the image inline as a base64-encoded standard MCP Image block. Supports screenshotting by monitor, window, and even pid (discovering the window dynamically by process ID, inclusive of child processes).

Installation

cargo install screenshot-mcp

Adding to AI Clients

Because this server interacts purely through the standardized stdio MCP transport, you can plug it into any compatible AI assistant. The configuration uses a standard shell one-liner to ensure the binary is installed securely and only compiled if it hasn't been already.

Claude Desktop

  1. Open your configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the server to the mcpServers object:
{
  "mcpServers": {
    "screenshot-mcp": {
      "command": "sh",
      "args": ["-c", "command -v screenshot-mcp >/dev/null 2>&1 || cargo install screenshot-mcp; screenshot-mcp"]
    }
  }
}

Cursor

  1. Open Cursor Settings (Cmd/Ctrl + Shift + J).
  2. Go to Features > MCP Servers.
  3. Click + Add new MCP server and set:
    • Type: command
    • Name: screenshot-mcp
    • Command: sh -c "command -v screenshot-mcp >/dev/null 2>&1 || cargo install screenshot-mcp; screenshot-mcp"

GitHub Copilot (VS Code)

  1. Open your VS Code settings.json.
  2. Add the server to Copilot's experimental MCP mapping:
{
  "github.copilot.chat.experimental.mcp.servers": {
    "screenshot-mcp": {
      "command": "sh",
      "args": ["-c", "command -v screenshot-mcp >/dev/null 2>&1 || cargo install screenshot-mcp; screenshot-mcp"]
    }
  }
}

Note: The first time Copilot or Claude connects, if you haven't run the tool yet, Cargo will do a one-time build that takes around ~30-60 seconds. Every subsequent boot will be instant!