Winsight

io.github.TheoEwzZerPublished by GitHub account TheoEwzZerv0.1.1Updated Nov 10, 2026

Windows Screen Capture MCP Server — give Claude Code eyes on your desktop.

VerifiedSTDIODesktop onlyBrowser AutomationDeveloper Tools

Overview

AI-generated overview

Windows-only MCP server that lets an assistant screenshot the desktop, inspect and control windows, and launch applications.

What you can do
  • Capture the full screen, a chosen monitor, a rectangular region, or a specific window by title, including windows hidden behind others
  • List and inspect open windows and monitors with title, position, size, state and resolution
  • Move, resize, minimize, maximize, restore and focus windows, and wait for a window to appear
  • Launch applications and optionally wait for their window
When to use it
Useful when an assistant working on a Windows desktop needs to see what is on screen, verify a GUI state after a change, or drive windows and applications as part of a local workflow.
Requirements
Runs as a local stdio process on Windows 10/11 with Python 3.10+; installed via uvx, pip (winsight-mcp), or from source. No accounts, API keys or environment variables are declared.
Before you install
Screenshots capture whatever is visible on the desktop, which may include private or sensitive content sent to the model. Window control and application launching act on the real desktop and can move, resize or start programs; review actions before approving them.

Installation

In SourceWeft

  1. Open Winsight in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

WinSight MCP

mcp-name: io.github.TheoEwzZer/winsight

Windows Screen Capture MCP Server — give Claude Code eyes on your Windows desktop.

WinSight is an MCP server that lets Claude Code capture your screen, manage windows, and launch applications on Windows.

Features

  • Screenshot the full screen, a specific region, or a specific window
  • Window capture uses Win32 PrintWindow API — captures the real window content even when it's behind other windows
  • List and inspect open windows and monitors (title, position, size, state, resolution)
  • Control windows — move, resize, minimize, maximize, restore, and focus
  • Launch applications and wait for their windows

Requirements

  • Windows 10/11
  • Python 3.10+

Quick Start

Option 1: uvx (recommended)

No install needed — runs directly:

json
{  "mcpServers": {    "winsight": {      "command": "uvx",      "args": ["winsight-mcp"]    }  }}

Add this to your project's .mcp.json or ~/.claude/claude_desktop_config.json.

Option 2: pip install

bash
pip install winsight-mcp

Then configure:

json
{  "mcpServers": {    "winsight": {      "command": "winsight-mcp"    }  }}

Option 3: From source

bash
git clone https://github.com/TheoEwzZer/WinSight-MCP.gitcd WinSight-MCPuv sync
json
{  "mcpServers": {    "winsight": {      "command": "uv",      "args": ["--directory", "/path/to/WinSight-MCP", "run", "winsight-mcp"]    }  }}

Tools

Screenshot

ToolDescription
take_screenshotCapture the full screen or a specific monitor
screenshot_windowCapture a specific window by title (works even if behind other windows)
screenshot_regionCapture a rectangular region of the screen

Window Management

ToolDescription
list_windowsList all visible windows with optional title filter
get_window_infoGet detailed info about a window (position, size, state)
focus_windowBring a window to the foreground
resize_windowResize a window to specific dimensions
move_windowMove a window to a specific position
minimize_windowMinimize a window to the taskbar
maximize_windowMaximize a window to fill the screen
restore_windowRestore a minimized or maximized window to its normal state
wait_for_windowWait for a window to appear (adaptive polling with timeout)

System

ToolDescription
list_monitorsList all monitors with resolution, position, and primary flag
open_applicationLaunch an application and optionally wait for its window

Examples

Once the MCP server is connected, you can ask Claude Code things like:

  • "Take a screenshot of my screen"
  • "List all open windows"
  • "Capture the Notepad window"
  • "Open calculator and take a screenshot of it"
  • "Focus the Chrome window"
  • "Resize the app window to 800x600 and take a screenshot"
  • "Move the window to the top-left corner"
  • "What monitors do I have?"

Testing

The project has 112 tests covering all modules. Tests use mocks for Win32 APIs so they run on any platform.

Running tests

bash
uv run pytest

Test structure

text
tests/  conftest.py              # Shared fixtures and Win32 stubs  test_types.py            # TypedDict definitions validation  test_screenshot.py       # Screen/region/window capture (mss, Win32 DC)  test_window_manager.py   # Window listing, find, focus, resize, move, min/max/restore  test_process_manager.py  # Application launch and window polling  test_server.py           # MCP tool registration and integration

Adding tests

  1. Put new tests in the matching test_<module>.py file
  2. Use the shared fixtures from conftest.py (sample_window_info, mcp_server, fake_png_bytes)
  3. Mock Win32 APIs with @patch("winsight_mcp.<module>.win32gui") — never call real Win32 functions in tests
  4. For server integration tests, use the _call helper to invoke tools and _text to extract string results

License

MIT

Source: README.md at commit 44dd4e9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts