使用说明
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
许可证
麻省理工学院
