Windows屏幕捕获服务

一个用于捕获Windows屏幕截图并将其作为base64编码图像与LLMs共享的MCP服务器。

  • by NHidano
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 NHidano/WindowsCaptureMCP

使用说明

Windows捕获MCP

MCP(模型上下文协议)服务器,用于捕获Windows屏幕截图并将其作为base64编码的图像与LLM共享。

仅限Windows --此软件包需要Windows,并使用Win32 API进行屏幕捕获和窗口管理。

特性

  • 列出并过滤可见窗口
  • 捕获窗口、全屏或自定义区域
  • 低质量预览图像,可在完全捕获之前快速验证
  • 窗口管理(聚焦、最大化、调整大小、移动)
  • 多显示器支持
  • PNG/JPEG/WebP输出格式

需求

  • 视窗
  • Python>=3.11

安装

# Using uvx (recommended)
uvx windows-capture-mcp

# Using pip
pip install windows-capture-mcp

MCP客户端配置

克劳德代码

运行以下命令注册MCP服务器:

# Register for all projects (user scope)
claude mcp add windows-capture-mcp -s user -- uvx windows-capture-mcp

# Register for the current project only (project scope)
claude mcp add windows-capture-mcp -s project -- uvx windows-capture-mcp

注册后,重新启动Claude Code以加载新的MCP服务器。您可以验证它是否正在运行 /mcp.

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "windows-capture-mcp": {
      "command": "uvx",
      "args": ["windows-capture-mcp"]
    }
  }
}

可用工具

信息

工具 说明
list_windows 列出带有可选标题过滤的可见窗口(不区分大小写)
list_displays 列出所有连接的显示器,包括分辨率、位置和比例信息

屏幕截图(全质量)

工具 说明
capture_window 按句柄捕获特定窗口
capture_fullscreen 捕获整个显示器
capture_region 捕捉矩形区域

支持所有捕获工具 format ("png", "jpeg", "webp")以及 quality (1-100)参数。

预览(轻量级)

工具 说明
preview_window 窗口的低质量预览
preview_fullscreen 显示器的低质量预览
preview_region 区域的低质量预览

预览图像为JPEG格式,质量为30,最长边最大调整为1280px。在拍摄全质量屏幕截图之前,使用这些来验证捕获目标。

窗口管理

工具 说明
focus_window 把窗户带到前台
maximize_window 最大化窗口
resize_window 调整窗口大小(保持位置)
move_window 移动窗口(保持大小)

用法示例

1. list_windows(filter="Chrome")       → Find browser windows
2. preview_window(hwnd=12345)           → Quick preview to verify
3. capture_window(hwnd=12345)           → Full-quality capture

许可证

麻省理工学院