WinBridgeAgent

WinBridgeAgent

中文文档

WinBridgeAgent is an open-source Windows local capability service that implements the Model Context Protocol (MCP) standard, providing traceable Windows system operations for AI assistants such as Claude Desktop, OpenAI, etc.

WinBridgeAgent Pro (Free Download)

In addition to the open-source edition, WinBridgeAgent Pro is now available as a free download.

The Pro edition is designed for users who need a more complete Windows Agent/Node experience, with ongoing improvements toward a more production-ready Windows node (closer to the OpenClaw Node experience).

Key enhancement areas (ongoing) include:

• Stronger media capabilities: camera photo/video capture and screen recording
• Deeper system integration: notifications, location, audio, and related OS features
• More powerful automation: expanded shell command execution with permission/safety controls
• Better production readiness: timeout handling, resource cleanup, error handling, and stability work

See details and download here:

• https://codyard.dev/winbridgeagentpro

Architecture

+------------------------------------------------------+

| Local Area Network (LAN) | | | | +--------------------+ | | | MCP Client | | | | (OpenClaw / Agent) | | | | - LLM reasoning | | | | - Tool planning | | | +---------+----------+ | | | MCP Protocol (HTTP/SSE) | | | | | +---------v------------------------------------+ | | | Windows PC | | | | | | | | +--------------------------------------+ | | | | | WinBridgeAgent | | | | | | (Local Tray MCP Server) | | | | | | | | | | | | - MCP Server (localhost / LAN) | | | | | | - Policy & Permission Guard | | | | | | - Tool Execution Layer | | | | | | - Audit & Logging | | | | | +-----------+--------------------------+ | | | | | | | | | +--------v--------+ | | | | | Windows System | | | | | | APIs / Resources| | | | | | (FS / Screen / | | | | | | Clipboard / | | | | | | Process etc.) | | | | | +-----------------+ | | | | | | | +----------------------------------------------+ | | | +------------------------------------------------------+

Optional External Dependencies:

• GitHub Releases (Auto Update)
• Optional Remote Services (APIs, Cloud tools)

Features

Core

• MCP Protocol: Full Model Context Protocol implementation
• UTF-8 Compatibility: MCP tool outputs are UTF-8 encoded, including non-ASCII Windows paths
• HTTP API: HTTP interface for remote control
• Real-time Monitoring: Dashboard window with live request/response display
• Audit Logging: Complete operation logging
• System Tray: Convenient graphical management interface
• Flexible Configuration: Switch between 0.0.0.0 and 127.0.0.1 listen address
• Auto Update: Automatic GitHub release checking with one-click download

File & System Operations

• File Reading: Disk enumeration, directory listing, file reading (line ranges), content search
• File Operations: Delete, copy, move, create directories
• Clipboard: Read/write clipboard content via HTTP API (text, images, files)
• Screenshots:
• Full screen (HTTP API, PNG/JPEG)
• Window capture (MCP tool, by window title)
• Region capture (MCP tool, by coordinates)

Process & Window Management

• Window Management: List all open windows with details
• Process Queries: List all running processes with details
• Process Management: Terminate processes, adjust priority (with protected process blocklist)
• Command Execution: Execute system commands and capture output

Power Management

• Shutdown: Delayed, forced, with custom message
• Restart: Delayed, forced
• Hibernate & Sleep: System hibernate and sleep
• Cancel Shutdown: Cancel scheduled shutdown/restart

Auto Update

• Version Check: Automatic GitHub release checking
• Update Notification: Friendly notification dialog
• One-click Download: Open GitHub Release page
• Multi-channel: Stable and Beta channels
• Multi-language: Simplified Chinese, English

System Requirements

• Windows 10/11 (x64, x86, ARM64)
• No additional runtime dependencies

Quick Start

Install from MCP Registry

WinBridgeAgent is published on the MCP Registry as io.github.codyard/winbridgeagent. MCP clients that support the registry can install it directly.

Manual Install

1. Download the latest release from GitHub Releases
2. Run WinBridgeAgent-x64.exe (64-bit) or WinBridgeAgent-x86.exe (32-bit)
3. The program appears in the system tray
4. Configure your MCP client (see below)

For OpenClaw + Windows node setup, see windows-node-install.en.md.

MCP Client Configuration

WinBridgeAgent works with any MCP-compatible client. Below are setup instructions for popular clients.

Note: Replace with the IP address of the Windows PC running WinBridgeAgent (e.g. 192.168.1.100). Use localhost only if the MCP client runs on the same Windows machine.

Claude Desktop

Edit claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{

"mcpServers": { "winbridgeagent": { "url": "http:// :35182", "transport": "http" } } }

Cursor

1. Open Settings → MCP
2. Click Add new MCP server
3. Fill in:

• Name: winbridgeagent
• Type: http
• URL: http:// :35182

Or edit .cursor/mcp.json in your project root:

{

"mcpServers": { "winbridgeagent": { "url": "http:// :35182", "transport": "http" } } }

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "winbridgeagent": { "serverUrl": "http:// :35182" } } }

OpenClaw

1. Open Settings → MCP Servers
2. Click Add
3. Set:

• Name: winbridgeagent
• Transport: HTTP
• URL: http:// :35182

For a step-by-step Windows node deployment walkthrough (including mcporter pairing), see windows-node-install.en.md.

Cherry Studio

1. Open Settings → MCP Servers
2. Click Add Server
3. Select Streamable HTTP type
4. Set URL to http:// :35182

Cline (VS Code)

Edit cline_mcp_settings.json in your VS Code settings:

{

"mcpServers": { "winbridgeagent": { "url": "http:// :35182", "transportType": "http" } } }

Generic MCP Client

Any MCP client that supports HTTP transport can connect using:

• Server URL: http:// :35182
• Transport: HTTP (Streamable HTTP)
• Protocol Version: 2024-11-05

HTTP API

The server listens on the configured port (default 35182).

Open-source edition: No Bearer Token authentication required. All API endpoints are directly accessible.

Endpoints

Examples

Replace below with the actual IP of your Windows PC (or use localhost if testing on the same machine).

# Server status

curl http:// :35182/health

List disks

curl http:// :35182/disks

List directory

curl "http:// :35182/list?path=C:\\"

Read file

curl "http:// :35182/read?path=C:\\test.txt"

Search file content

curl "http:// :35182/search?path=C:\\test.txt&query=keyword"

Read clipboard

curl http:// :35182/clipboard

Write clipboard

curl -X PUT -H "Content-Type: application/json" \ -d '{"content":"Hello World"}' http:// :35182/clipboard

Take screenshot

curl http:// :35182/screenshot

List windows

curl http:// :35182/windows

List processes

curl http:// :35182/processes

Execute command

curl -X POST -H "Content-Type: application/json" \ -d '{"command":"echo Hello"}' http:// :35182/execute

MCP: Initialize

curl -X POST -H "Content-Type: application/json" \ -d '{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}' \ http:// :35182/mcp/initialize

MCP: List tools

curl -X POST -H "Content-Type: application/json" \ -d '{}' http:// :35182/mcp/tools/list

MCP: Call tool

curl -X POST -H "Content-Type: application/json" \ -d '{"name":"list_windows","arguments":{}}' \ http:// :35182/mcp/tools/call

Shutdown server

curl http:// :35182/exit

If you have multiple computers with WinBridgeAgent installed on your LAN, configure your MCP client to manage them:

{

"mcpServers": { "winbridge-test": { "url": "http://192.168.31.3:35182", "description": "Test PC" }, "winbridge-office": { "url": "http://192.168.31.4:35182", "description": "Office PC" } } }

See [Multi-Computer Setup Guide](docs/MULTI_COMPUTER_