home / mcp / getscreen mcp server

GetScreen MCP Server

simple screenshot tool

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "kirchlive-getscreen_mcp": {
      "command": "node",
      "args": [
        "/ABSOLUT/PATH/TO/getscreen_mcp/build/index.js"
      ]
    }
  }
}

GetScreen MCP Server is a lightweight server that captures screenshots from all connected monitors with automatic JPEG compression, enabling rapid sharing or processing of multi-monitor layouts across MCp clients and environments.

How to use

You will interact with GetScreen MCP Server through an MCP client. The server exposes a single local endpoint, so you can request screenshots from all active displays and receive them as base64-encoded JPEGs. You can adjust quality and maximum width to balance image fidelity and payload size. Use the client to trigger captures whenever you need a multi-monitor overview or to automate visual reporting across your setup.

How to install

Prerequisites: install Node.js and npm on your system.

Clone the project repository and set up the server dependencies, then build the MCP server artifact.

git clone https://github.com/Kirchlive/getscreen_mcp.git
cd getscreen_mcp
npm install
npm run build

Configuration

Configure the MCP server in your Claude configuration to define how the server is started. The following example shows the stdio method using Node to run the built entry point.

{
  "mcpServers": {
    "getscreen": {
      "command": "node",
      "args": ["/ABSOLUT/PATH/TO/getscreen_mcp/build/index.js"]
    }
  }
}

Notes

The server is designed to work across Linux, macOS, Windows, and Windows Subsystem for Linux (WSL). It automatically detects the environment and uses the most suitable capture path, including PowerShell on Windows hosts when operating under WSL.

Available tools

screenshot

Captures all connected displays and returns base64-encoded JPEG images.

compression

Uses sharp for fast JPEG compression of captured images.

wsL-detection

Automatic environment detection for WSL and native systems to choose the appropriate capture method.