MCP.so
Sign In

Screenshot Server

@KunihiroS

Repository

About Screenshot Server

MCP Server for local screen shot.

#screenshot#mcp-server#image-capture

Basic information

Category

Browser Automation

Runtime

python

Transports

stdio

Publisher

KunihiroS

Submitted by

Kunihiro Sugiyama

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Screenshot-server": {
      "command": "powershell.exe",
      "args": [
        "-Command",
        "Invoke-Command -ScriptBlock { cd '<YOUR_WINDOWS_PROJECT_PATH>'; & '<YOUR_WINDOWS_UV_PATH>' run screenshot.py }"
      ]
    }
  }
}

Tools

7

** Takes a screenshot, converts the provided WSL path to a UNC path, and saves the file to the Host's workspace. Automatically detects the WSL distribution name.

`host_workspace_path` (str): The absolute WSL path of the Host's workspace (e.g., `/home/user/project`).

** `str` - `"success"` or `"failed: [error message]"`.

`name` (str, optional): Filename. Defaults to `latest_screenshot.jpg`.

** `str` - Absolute path or `"failed: [error message]"`.

`path` (str, optional): Target directory (Windows or UNC path). Defaults to server's working directory.

** `str` - `"success"` or `"failed: [error message]"`.

Overview

What is Screenshot Server?

Screenshot Server is an MCP (Modular Communication Protocol) server that captures screenshots and saves them to a file path specified by the client, enabling AI assistants or other processes to access the screenshot via its file path.

How to use Screenshot Server?

Deploy the server on Windows (required for capturing the Windows screen), install dependencies with uv sync, and configure the MCP host to launch it (e.g., via PowerShell in WSL). Use the provided tools: save_screenshot_to_host_workspace, take_screenshot_and_return_path, or take_screenshot_path.

Key features of Screenshot Server

  • Captures the entire Windows screen.
  • Saves screenshots to a file path specified by the client.
  • Converts WSL paths to Windows UNC paths automatically.
  • Provides three tools with different save destinations.
  • Logs server activity to server.log.

Use cases of Screenshot Server

  • An AI assistant in WSL captures a screenshot and saves it directly into its workspace.
  • A process saves a screenshot to a fixed images/ directory and returns the absolute path.
  • A user saves a screenshot to an arbitrary Windows or UNC path for external processing.

FAQ from Screenshot Server

What is the recommended workflow for WSL2?

The recommended workflow uses save_screenshot_to_host_workspace with WSL workspace path; the server converts it to a UNC path, saves the screenshot, and returns "success".

What tools does Screenshot Server provide?

Three tools: save_screenshot_to_host_workspace (recommended), take_screenshot_and_return_path, and take_screenshot_path.

Where does Screenshot Server save screenshots?

It saves to a path specified by the client: either the host’s workspace (via UNC path conversion), a local images/ directory, or an arbitrary directory given as a Windows or UNC path.

What are the runtime requirements?

Python 3.x, dependencies mcp[cli]>=1.4.1, pyautogui, and Pillow, installed via uv sync. The server must run directly on Windows to capture the screen.

Does Screenshot Server support authentication or transport layers?

—

Comments

More Browser Automation MCP servers

App Store Scraper MCP Server

appreply-co

This is an MCP server that provides tools to LLMs for searching and analyzing apps from both Google Play Store and Apple App Store – perfect for ASO.

60

Firecrawl Mcp Server

mendableai

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

6.9K

X Twitter Scraper

Xquik-dev

Twitter scraper API skill for tweet search, advanced Twitter search, profile tweets, follower export, media download, monitors, webhooks, MCP, and posting automation: send tweets and replies.

135

Webpage Screenshot MCP Server

ananddtyagi

An MCP that gives your agent the ability to snap a screenshot of webpages. Useful when you want your agent to check its progress during development.

58

Fetch MCP

jae-jae

MCP server for fetch web page content using Playwright headless browser.

1.1K