内容
语言选项 /
**简体中文**
---
# WinCapture-MCP
WinCapture-MCP 是一款使用 Rust 开发，专为 Windows 设计的 MCP 服务器工具。它允许 MCP 客户端捕获并查看指定窗口的截图。
该工具可以捕获被其他窗口覆盖的窗口，但无法捕获最小化的窗口。
---
## 使用方法
### 标准安装
1. 从 [发布页面](https://github.com/DamoyY/WinCapture-MCP/releases/latest) 下载压缩包。
2. 将可执行文件解压到任意位置，并记住其路径。
3. 将此 MCP 服务器添加到您的客户端。
#### 手动构建
1. 克隆或下载该项目的源代码。
2. 在项目根目录（`Cargo.toml` 所在目录）打开终端。
3. 运行以下命令来构建项目：
```cmd
cargo build --release
```
构建完成后，可执行文件将生成在 `./target/release/WinCapture.exe`。
### MCP 客户端配置
要将此工具与 MCP 客户端一起使用，请将服务器添加到客户端的配置文件中。
#### 示例：
**Claude 代码**：
```cmd
claude mcp add WinCapture -- X:/example/path/WinCapture.exe
```
**Codex CLI**：
```
codex mcp add WinCapture -- X:/example/path/WinCapture.exe
```
完成配置后，重启 MCP 客户端使更改生效。
---
## 可用的 MCP 工具
此服务器为 MCP 客户端提供以下两个工具：
### `search_hwnd`
* **描述**：以进程名称作为输入，返回匹配的窗口 HWND 列表以及窗口元数据。
* **参数**：
* `process_name`（字符串）：目标进程的名称。匹配不区分大小写，`.exe` 后缀是可选的。
* **返回值**：包含所有找到的窗口信息的结构化 JSON 数据。
### `window_screenshot`
* **描述**：以 HWND 作为输入，返回对应窗口的截图。
* **参数**：
* `hwnd`（字符串）：目标窗口的句柄。支持十六进制和十进制格式。
* **返回值**：以 `image/png` MIME 类型返回的 MCP 内容图像。
---
## 系统要求
* **操作系统**：Windows 10 或 Windows 11。系统必须支持 `Windows.Graphics.Capture` API。
* **开发环境**：Rust 工具链，2024 版。
