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:

{
  "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

pip install winsight-mcp

Then configure:

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

Option 3: From source

git clone https://github.com/TheoEwzZer/WinSight-MCP.git
cd WinSight-MCP
uv sync

{
  "mcpServers": {
    "winsight": {
      "command": "uv",
      "args": ["--directory", "/path/to/WinSight-MCP", "run", "winsight-mcp"]
    }
  }
}

Tools

Screenshot

Window Management

System

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

uv run pytest

Test structure

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