Language Option / 语言选项：

English | 简体中文

---

WinCapture-MCP

WinCapture-MCP is an MCP server tool developed in Rust and designed for Windows. It allows MCP clients to capture and view screenshots of specified windows.

This tool can capture windows even when they are covered by other windows, but it cannot capture minimized windows.

---

Usage

Standard Installation

1. Download the archive from the Releases page.
2. Extract the executable to any location and remember its path.
3. Add this MCP server to your client.

Manual Build

1. Clone or download the source code of this project.
2. Open a terminal in the project root directory, where Cargo.toml is located.
3. Run the following command to build the project:

cargo build --release

After the build is complete, the executable will be generated at ./target/release/WinCapture.exe.

MCP Client Configuration

To use this tool with an MCP client, add the server to the client’s configuration file.

Examples:

Claude Code:

claude mcp add WinCapture -- X:/example/path/WinCapture.exe

Codex CLI：

codex mcp add WinCapture -- X:/example/path/WinCapture.exe

After completing the configuration, restart the MCP client for the changes to take effect.

---

Available MCP Tools

This server provides the following two tools to MCP clients:

search_hwnd

• Description: Takes a process name as input and returns a list of matching window HWNDs along with window metadata.
• Parameters:
  • process_name (string): The name of the target process. Matching is case-insensitive, and the .exe suffix is optional.
• Return Value: Structured JSON data containing information about all found windows.

window_screenshot

• Description: Takes an HWND as input and returns a screenshot of the corresponding window.
• Parameters:
  • hwnd (string): The handle of the target window. Both hexadecimal and decimal formats are supported.
• Return Value: An image returned as MCP Content with the image/png MIME type.

---

System Requirements

• Operating System: Windows 10 or Windows 11. The system must support the Windows.Graphics.Capture API.
• Development Environment: Rust toolchain, 2024 Edition.