Windows Screenshot

FreeNot checked

🚀 Production-ready Windows Screenshot MCP Server with real-time WebSocket streaming, Chrome DevTools integration, and comprehensive APIs. Built with Go for hig

by amafjarkasi

GitHub Embed

About

🚀 Production-ready Windows Screenshot MCP Server with real-time WebSocket streaming, Chrome DevTools integration, and comprehensive APIs. Built with Go for high-performance native Windows screenshot automation.

README

Go Version License MCP Compatible

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.

Query Parameters:

fps: Frames per second (1-60, default: 10)
quality: Compression quality (10-100, default: 75)
format: jpeg or png (default: jpeg)

Client Example:

<!DOCTYPE html>
<html>
<body>
    <img id="stream" style="max-width: 100%;">
    <script>
        const ws = new WebSocket('ws://localhost:8080/stream/0?fps=15&quality=75&format=jpeg');
        ws.onmessage = function(event) {
            const data = JSON.parse(event.data);
            if (data.type === 'frame') {
                document.getElementById('stream').src = 'data:image/jpeg;base64,' + data.image;
            }
        };
    </script>
</body>
</html>

Model Context Protocol (MCP)

The server supports MCP JSON-RPC 2.0 requests via POST /rpc.

Available Methods:

screenshot.capture - Capture screenshots
window.list - List windows (placeholder)
chrome.instances - List Chrome instances
chrome.tabs - List Chrome tabs
chrome.tabCapture - Capture Chrome tab
stream.status - Get streaming status

Example MCP Request:

{
  "jsonrpc": "2.0",
  "method": "screenshot.capture",
  "params": {
    "method": "title",
    "target": "Calculator",
    "format": "png"
  },
  "id": 1
}

Server Configuration

The server can be configured via environment variables or command-line flags:

# Start with custom port
./server.exe --port 9090

# Start with custom host
./server.exe --host 0.0.0.0 --port 8080

# Environment variables
export SCREENSHOT_PORT=8080
export SCREENSHOT_HOST=localhost
./server.exe

Examples & Use Cases

Basic Examples

Single Window Capture - Simple window screenshots with REST API, CLI, and programming examples

Streaming & Real-time

WebSocket Live Streaming - Real-time window feeds with JavaScript, Python, and Node.js clients

Hidden & System Integration

Hidden Window Capture - Advanced techniques for minimized and system tray applications

Browser Integration

Chrome Tab Capture - Direct browser tab screenshots with Chrome DevTools integration

Testing & Quality Assurance

Visual Regression Testing - Automated UI change detection with Python framework

Advanced Configuration

Server Configuration

The server uses a default configuration that can be customized:

// Default settings
type Config struct {
    Port              int    // Default: 8080
    Host              string // Default: "localhost"
    DefaultFormat     string // Default: "png"
    Quality           int    // Default: 95
    IncludeCursor     bool   // Default: false
    LogLevel          string // Default: "info"
    ChromeTimeout     string // Default: "30s"
    StreamMaxSessions int    // Default: 10
    StreamDefaultFPS  int    // Default: 10
}

Chrome DevTools Setup

For Chrome tab capture, launch Chrome with debugging enabled:

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

# Launch with temporary profile
chrome.exe --remote-debugging-port=9222 --user-data-dir=temp-profile

Building from Source

Prerequisites

Go 1.21 or later
Windows OS (for Windows API support)
Git

Build Instructions

# Clone the repository
git clone https://github.com/your-org/screenshot-mcp-server.git
cd screenshot-mcp-server

# Install dependencies
go mod download

# Build the server
go build -o server.exe ./cmd/server

# Run tests
go test ./...

# Start the server
./server.exe

Project Structure

├── cmd/
│   ├── server/          # Main server application
│   └── mcpctl/          # MCP control utility
├── internal/
│   ├── screenshot/      # Screenshot capture engines
│   ├── chrome/          # Chrome DevTools integration
│   ├── window/          # Window management
│   └── ws/              # WebSocket streaming
├── pkg/
│   └── types/           # Shared data structures
└── examples/            # Usage examples and documentation

Architecture

The server follows a modular architecture:

HTTP Server (Gin framework) - REST API endpoints
WebSocket Manager - Real-time streaming support
Screenshot Engine - Core capture functionality with multiple methods
Chrome Manager - Browser integration via DevTools protocol
MCP Handler - JSON-RPC 2.0 support for AI agents

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Issues: GitHub Issues
Documentation: See /examples directory for usage examples

A powerful Windows screenshot server built for modern automation and AI integration.

from github.com/amafjarkasi/windows-screenshot-mcp-server

Installing Windows Screenshot

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/amafjarkasi/windows-screenshot-mcp-server

FAQ

Is Windows Screenshot MCP free?

Yes, Windows Screenshot MCP is free — one-click install via Unyly at no cost.

Does Windows Screenshot need an API key?

No, Windows Screenshot runs without API keys or environment variables.

Is Windows Screenshot hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Windows Screenshot in Claude Desktop, Claude Code or Cursor?

Open Windows Screenshot on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Playwright

Browser automation, scraping, screenshots

by Microsoft

Puppeteer

Browser automation and web scraping.

by modelcontextprotocol

opentabs-dev/opentabs

Plugin-based MCP server + Chrome extension that gives AI agents access to web applications through the user's authenticated browser session. 100+ plugins with a

by opentabs-dev

robhunter/agentdeals

1,500+ developer infrastructure deals, free tiers, and startup programs across 54 categories. Search deals, compare vendors, plan stacks, and track pricing chan

by robhunter

Compare Windows Screenshot with

Windows ScreenshotvsPlaywright Windows ScreenshotvsPuppeteer Windows Screenshotvsopentabs-dev/opentabs Windows Screenshotvsrobhunter/agentdeals

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All browse MCPs

Command Palette

Windows Screenshot

About

README

Overview

Features

Core Screenshot Capabilities

Chrome Browser Integration

Real-Time WebSocket Streaming

Dual Protocol Support

Quick Start

Installation

Basic Usage

API Reference

REST Endpoints

Health Check

Screenshot Capture

Chrome Integration

WebSocket Streaming

Model Context Protocol (MCP)

Server Configuration

Examples & Use Cases

Basic Examples

Streaming & Real-time

Hidden & System Integration

Browser Integration

Testing & Quality Assurance

Advanced Configuration

Server Configuration

Chrome DevTools Setup

Building from Source

Prerequisites

Build Instructions

Project Structure

Architecture

License

Support

Installing Windows Screenshot

FAQ

Is Windows Screenshot MCP free?

Does Windows Screenshot need an API key?

Is Windows Screenshot hosted or self-hosted?

How do I install Windows Screenshot in Claude Desktop, Claude Code or Cursor?

Related MCPs

Playwright

Puppeteer

opentabs-dev/opentabs

robhunter/agentdeals

Compare Windows Screenshot with