Winsight

io.github.TheoEwzZer由 GitHub 帳號 TheoEwzZer 發布v0.1.1更新於 Nov 10, 2026

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

已驗證STDIO僅桌面瀏覽器自動化開發者工具

概覽

AI 產生的概覽

讓助理在本地 Windows 桌面上擷取畫面、檢視與控制視窗，並啟動應用程式。

可以做什麼
WinSight 是針對 Windows 的本地 MCP 伺服器，為助理提供桌面可見度與控制能力。它可以擷取整個畫面、某個螢幕、矩形區域或指定視窗，視窗擷取使用 Win32 PrintWindow API，即使視窗被其他視窗遮住也能取得真實內容。它也能列出並檢視開啟的視窗與螢幕，移動、調整大小、最小化、最大化、還原與聚焦視窗，等待視窗出現，以及啟動應用程式。
適用情境
當助理需要查看或操作 Windows 桌面時使用：擷取畫面以提供視覺脈絡、查看已開啟的視窗與螢幕、排列或聚焦視窗，或啟動某個應用程式並擷取其視窗。
執行需求
需要 Windows 10 或 11 以及 Python 3.10 或更新版本。以本地 stdio 程序執行，從 PyPI 套件 winsight-mcp 安裝，例如透過 uvx 或 pip。未宣告任何身分驗證、API 金鑰或環境變數。
安裝前請注意
此伺服器可以擷取畫面與視窗內容，其中可能包含敏感或個人資訊；它也能移動、調整大小、最小化、最大化、還原、聚焦與啟動應用程式，因而改變桌面狀態。啟用前請確認它可擷取與控制的範圍。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Winsight，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 44dd4e9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分