Windows Screenshot MCP Server

Professional Windows screenshot capture server with Model Context Protocol (MCP) integration, real-time WebSocket streaming, Chrome tab capture, and advanced window targeting.

Overview

A production-ready Go-based screenshot server that provides both REST API and MCP protocol support for capturing Windows application screenshots. Designed for automation, testing, and AI agent integration with advanced features like real-time streaming and hidden window capture.

Features

Core Screenshot Capabilities

• Window targeting: Capture by title, class name, process ID, or window handle
• Multiple image formats: PNG, JPEG, BMP, WebP with configurable quality
• Region capture: Specify rectangular areas for precise screenshots
• Advanced window handling: Support for hidden, minimized, and system tray applications

Chrome Browser Integration

• Tab discovery: Automatically find Chrome instances and enumerate tabs
• Direct tab capture: Screenshot specific browser tabs via Chrome DevTools
• Multiple Chrome support: Handle multiple Chrome processes simultaneously

Real-Time WebSocket Streaming

• Live streaming: Real-time window feeds via WebSocket connections
• Configurable quality: Adjust FPS (1-60), quality, and format dynamically
• Multiple sessions: Support concurrent streaming sessions
• Session management: Start, stop, and monitor active streaming sessions

Dual Protocol Support

• REST API: Traditional HTTP endpoints for easy integration
• Model Context Protocol (MCP): JSON-RPC 2.0 for AI agent integration
• Health monitoring: Built-in health checks and status reporting
• CORS support: Cross-origin requests enabled for web applications

Quick Start

Installation

# Download latest release
curl -L https://github.com/your-org/screenshot-mcp-server/releases/latest/download/screenshot-server.exe -o screenshot-server.exe

# Or build from source
git clone https://github.com/your-org/screenshot-mcp-server.git
cd screenshot-mcp-server
go build -o screenshot-server.exe ./cmd/server

Basic Usage

# Start the server
./screenshot-server.exe --port 8080

# Health check
curl http://localhost:8080/health

# Basic window capture
curl "http://localhost:8080/api/screenshot?method=title&target=Notepad" -o notepad.png

# Full desktop capture
curl "http://localhost:8080/api/screenshot?method=desktop&monitor=0" -o desktop.png

API Reference

REST Endpoints

Health Check

GET /health

Returns server status and version information.

Screenshot Capture

GET /api/screenshot
GET /v1/screenshot

Parameters:

• method (required): title, pid, handle, class
• target (required): Window identifier (title, PID, handle, class name)
• format: png, jpeg, bmp, webp (default: png)
• quality: 1-100 for lossy formats (default: 95)
• cursor: true/false to include mouse cursor

Examples:

# Window by title
curl "http://localhost:8080/api/screenshot?method=title&target=Calculator" -o calc.png

# Window by PID
curl "http://localhost:8080/api/screenshot?method=pid&target=1234&format=jpeg&quality=80" -o app.jpg

# Window by class name
curl "http://localhost:8080/api/screenshot?method=class&target=Notepad&cursor=true" -o notepad.png

Chrome Integration

GET /v1/chrome/instances          # List Chrome instances
GET /v1/chrome/tabs               # List all Chrome tabs
POST /v1/chrome/tabs/:id/screenshot  # Capture specific tab

WebSocket Streaming

Connect to ws://localhost:8080/stream/{windowId} for real-time streaming.

**Qu

... View full README on GitHub