What is Screenshot Mcp Server

screenshot_mcp_server is an MCP server that provides screenshot capabilities for AI tools, enabling them to capture and process screen content effectively.

Use cases

Use cases include capturing user interface elements for testing, analyzing user interactions during usability studies, and enabling AI assistants to understand the user’s current screen context.

How to use

To use screenshot_mcp_server, you can either utilize the command line client to take screenshots directly or integrate it programmatically within your applications using the provided API.

Key features

Key features include full screen screenshot capture, automatic JPEG compression, base64 encoded image data for reliable transmission, configurable image quality, and support for both stdio and SSE transport modes.

Where to use

screenshot_mcp_server can be used in various fields such as AI development, software testing, and user experience research where screen content analysis is required.

Screenshot MCP Server

An MCP server that provides screenshot capabilities for AI tools, allowing them to capture and process screen content.

Overview

This MCP server enables AI tools to take screenshots of the user’s screen, making it possible for AI assistants to see and analyze what the user is looking at. The server handles image capture, compression, and delivery in a format suitable for AI processing.

Features

• Take full screen screenshots
• Automatic JPEG compression for efficient transfer
• Base64 encoded image data for reliable transmission
• Support for both stdio and SSE transport modes
• Configurable image quality and optimization
• Simple command-line interface for testing

Installation

From Source

# Clone the repository
git clone https://github.com/codingthefuturewithai/screenshot_mcp_server.git
cd screenshot_mcp_server

# Install using UV (recommended)
uv pip install -e .

# Or using pip
pip install -e .

Available Tools

take_screenshot

Description: Takes a screenshot of the user’s screen and returns it as a JPEG image.

Parameters: None

Returns:

• Image content in JPEG format, base64 encoded

Usage

The server can be used in two ways:

Command Line Client

# Take a screenshot and save it to a file
screenshot_mcp_server-client output.jpg

Programmatic Usage

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async with stdio_client(StdioServerParameters(command="screenshot_mcp_server-server")) as (read, write):
    async with ClientSession(read, write) as session:
        result = await session.call_tool("take_screenshot")
        # Process the screenshot data...

Requirements

• Python 3.10 or later (< 3.13)
• Dependencies:
  • mcp >= 1.0.0
  • pyautogui >= 0.9.54
  • Pillow >= 10.0.0
• Operating Systems: Linux, macOS, Windows

Configuration

The server supports two transport modes:

• stdio (default): For command-line usage
• SSE: For web-based applications, runs on port 3001 by default

To run in SSE mode:

screenshot_mcp_server-server-sse --port 3001

License

This project is licensed under the MIT License.

Author

Tim Kitchens ([email protected])