English Français العربية

io.github.TheoEwzZer/winsight

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.TheoEwzZer/winsight؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package winsight-mcp
Claude Code 
claude mcp add winsight -- uvx winsight-mcp==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "winsight": {
            "command": "uvx",
            "args": [
                "winsight-mcp==0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. WinSight MCP
  2. Features
  3. Requirements
  4. Quick Start
  5. Tools
  6. Examples
  7. Testing
  8. License

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

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

الأسئلة الشائعة

ما هو io.github.TheoEwzZer/winsight؟

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

كيف أثبّت io.github.TheoEwzZer/winsight؟

يعمل على جهازك. في Claude Code: claude mcp add winsight -- uvx winsight-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.TheoEwzZer/winsight إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.TheoEwzZer/winsight مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.TheoEwzZer/winsight؟

ينشره TheoEwzZer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.