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 分