{
  "markdown": "# WinBridgeAgent\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Platform: Windows](https://img.shields.io/badge/Platform-Windows%2010%2F11-0078D6?logo=windows)](https://github.com/codyard/WinBridgeAgent)\n[![C++17](https://img.shields.io/badge/C%2B%2B-17-00599C?logo=cplusplus)](https://en.cppreference.com/w/cpp/17)\n[![MCP Protocol](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-green)](https://modelcontextprotocol.io)\n[![GitHub Release](https://img.shields.io/github/v/release/codyard/WinBridgeAgent?include_prereleases&sort=semver)](https://github.com/codyard/WinBridgeAgent/releases)\n[![GitHub Stars](https://img.shields.io/github/stars/codyard/WinBridgeAgent?style=social)](https://github.com/codyard/WinBridgeAgent)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.codyard%2Fwinbridgeagent-orange)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.codyard/winbridgeagent)\n\n[中文文档](README_zh.md)\n\nWinBridgeAgent 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.\n\n## WinBridgeAgent Pro (Free Download)\n\nIn addition to the open-source edition, **WinBridgeAgent Pro** is now available as a free download.\n\nThe 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).\n\nKey enhancement areas (ongoing) include:\n\n- Stronger media capabilities: camera photo/video capture and screen recording\n- Deeper system integration: notifications, location, audio, and related OS features\n- More powerful automation: expanded shell command execution with permission/safety controls\n- Better production readiness: timeout handling, resource cleanup, error handling, and stability work\n\nSee details and download here:\n\n- https://codyard.dev/winbridgeagentpro\n\n## Architecture\n\n```\n+------------------------------------------------------+\n|                Local Area Network (LAN)              |\n|                                                      |\n|   +--------------------+                             |\n|   |   MCP Client       |                             |\n|   | (OpenClaw / Agent) |                             |\n|   |  - LLM reasoning   |                             |\n|   |  - Tool planning   |                             |\n|   +---------+----------+                             |\n|             | MCP Protocol (HTTP/SSE)                |\n|             |                                        |\n|   +---------v------------------------------------+   |\n|   |           Windows PC                          |   |\n|   |                                              |   |\n|   |   +--------------------------------------+   |   |\n|   |   |  WinBridgeAgent                      |   |   |\n|   |   |  (Local Tray MCP Server)             |   |   |\n|   |   |                                      |   |   |\n|   |   |  - MCP Server (localhost / LAN)      |   |   |\n|   |   |  - Policy & Permission Guard         |   |   |\n|   |   |  - Tool Execution Layer              |   |   |\n|   |   |  - Audit & Logging                   |   |   |\n|   |   +-----------+--------------------------+   |   |\n|   |               |                              |   |\n|   |      +--------v--------+                     |   |\n|   |      | Windows System  |                     |   |\n|   |      | APIs / Resources|                     |   |\n|   |      | (FS / Screen /  |                     |   |\n|   |      |  Clipboard /    |                     |   |\n|   |      |  Process etc.)  |                     |   |\n|   |      +-----------------+                     |   |\n|   |                                              |   |\n|   +----------------------------------------------+   |\n|                                                      |\n+------------------------------------------------------+\n\nOptional External Dependencies:\n- GitHub Releases (Auto Update)\n- Optional Remote Services (APIs, Cloud tools)\n```\n\n## Features\n\n### Core\n\n- **MCP Protocol**: Full Model Context Protocol implementation\n- **UTF-8 Compatibility**: MCP tool outputs are UTF-8 encoded, including non-ASCII Windows paths\n- **HTTP API**: HTTP interface for remote control\n- **Real-time Monitoring**: Dashboard window with live request/response display\n- **Audit Logging**: Complete operation logging\n- **System Tray**: Convenient graphical management interface\n- **Flexible Configuration**: Switch between 0.0.0.0 and 127.0.0.1 listen address\n- **Auto Update**: Automatic GitHub release checking with one-click download\n\n### File & System Operations\n\n- **File Reading**: Disk enumeration, directory listing, file reading (line ranges), content search\n- **File Operations**: Delete, copy, move, create directories\n- **Clipboard**: Read/write clipboard content via HTTP API (text, images, files)\n- **Screenshots**:\n  - Full screen (HTTP API, PNG/JPEG)\n  - Window capture (MCP tool, by window title)\n  - Region capture (MCP tool, by coordinates)\n\n### Process & Window Management\n\n- **Window Management**: List all open windows with details\n- **Process Queries**: List all running processes with details\n- **Process Management**: Terminate processes, adjust priority (with protected process blocklist)\n- **Command Execution**: Execute system commands and capture output\n\n### Power Management\n\n- **Shutdown**: Delayed, forced, with custom message\n- **Restart**: Delayed, forced\n- **Hibernate & Sleep**: System hibernate and sleep\n- **Cancel Shutdown**: Cancel scheduled shutdown/restart\n\n### Auto Update\n\n- **Version Check**: Automatic GitHub release checking\n- **Update Notification**: Friendly notification dialog\n- **One-click Download**: Open GitHub Release page\n- **Multi-channel**: Stable and Beta channels\n- **Multi-language**: Simplified Chinese, English\n\n## System Requirements\n\n- Windows 10/11 (x64, x86, ARM64)\n- No additional runtime dependencies\n\n## Quick Start\n\n### Install from MCP Registry\n\nWinBridgeAgent is published on the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.codyard/winbridgeagent`. MCP clients that support the registry can install it directly.\n\n### Manual Install\n\n1. Download the latest release from [GitHub Releases](https://github.com/codyard/WinBridgeAgent/releases)\n2. Run `WinBridgeAgent-x64.exe` (64-bit) or `WinBridgeAgent-x86.exe` (32-bit)\n3. The program appears in the system tray\n4. Configure your MCP client (see below)\n\nFor OpenClaw + Windows node setup, see [`windows-node-install.en.md`](./windows-node-install.en.md).\n\n## MCP Client Configuration\n\nWinBridgeAgent works with any MCP-compatible client. Below are setup instructions for popular clients.\n\n> **Note**: Replace `<windows-ip>` 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.\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json`:\n\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n```json\n{\n    \"mcpServers\": {\n        \"winbridgeagent\": {\n            \"url\": \"http://<windows-ip>:35182\",\n            \"transport\": \"http\"\n        }\n    }\n}\n```\n\n### Cursor\n\n1. Open **Settings** → **MCP**\n2. Click **Add new MCP server**\n3. Fill in:\n   - **Name**: `winbridgeagent`\n   - **Type**: `http`\n   - **URL**: `http://<windows-ip>:35182`\n\nOr edit `.cursor/mcp.json` in your project root:\n\n```json\n{\n    \"mcpServers\": {\n        \"winbridgeagent\": {\n            \"url\": \"http://<windows-ip>:35182\",\n            \"transport\": \"http\"\n        }\n    }\n}\n```\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n    \"mcpServers\": {\n        \"winbridgeagent\": {\n            \"serverUrl\": \"http://<windows-ip>:35182\"\n        }\n    }\n}\n```\n\n### OpenClaw\n\n1. Open **Settings** → **MCP Servers**\n2. Click **Add**\n3. Set:\n   - **Name**: `winbridgeagent`\n   - **Transport**: `HTTP`\n   - **URL**: `http://<windows-ip>:35182`\n\nFor a step-by-step Windows node deployment walkthrough (including `mcporter` pairing), see [`windows-node-install.en.md`](./windows-node-install.en.md).\n\n### Cherry Studio\n\n1. Open **Settings** → **MCP Servers**\n2. Click **Add Server**\n3. Select **Streamable HTTP** type\n4. Set URL to `http://<windows-ip>:35182`\n\n### Cline (VS Code)\n\nEdit `cline_mcp_settings.json` in your VS Code settings:\n\n```json\n{\n    \"mcpServers\": {\n        \"winbridgeagent\": {\n            \"url\": \"http://<windows-ip>:35182\",\n            \"transportType\": \"http\"\n        }\n    }\n}\n```\n\n### Generic MCP Client\n\nAny MCP client that supports HTTP transport can connect using:\n\n- **Server URL**: `http://<windows-ip>:35182`\n- **Transport**: HTTP (Streamable HTTP)\n- **Protocol Version**: `2024-11-05`\n\n## HTTP API\n\nThe server listens on the configured port (default 35182).\n\n> **Open-source edition**: No Bearer Token authentication required. All API endpoints are directly accessible.\n\n### Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | `/` | API endpoint list |\n| GET | `/health` | Health check |\n| GET | `/status` | Server status and info |\n| GET | `/disks` | List all disk drives |\n| GET | `/list?path=<path>` | List directory contents |\n| GET | `/read?path=<path>` | Read file content |\n| GET | `/search?path=<path>&query=<q>` | Search file content |\n| GET | `/clipboard` | Read clipboard |\n| PUT | `/clipboard` | Write clipboard |\n| GET | `/screenshot` | Take screenshot |\n| GET | `/windows` | List all windows |\n| GET | `/processes` | List all processes |\n| POST | `/execute` | Execute command |\n| GET | `/exit` | Shutdown server |\n| POST | `/mcp/initialize` | MCP initialize |\n| POST | `/mcp/tools/list` | MCP list tools |\n| POST | `/mcp/tools/call` | MCP call tool |\n\n### Examples\n\n> Replace `<windows-ip>` below with the actual IP of your Windows PC (or use `localhost` if testing on the same machine).\n\n```bash\n# Server status\ncurl http://<windows-ip>:35182/health\n\n# List disks\ncurl http://<windows-ip>:35182/disks\n\n# List directory\ncurl \"http://<windows-ip>:35182/list?path=C:\\\\\"\n\n# Read file\ncurl \"http://<windows-ip>:35182/read?path=C:\\\\test.txt\"\n\n# Search file content\ncurl \"http://<windows-ip>:35182/search?path=C:\\\\test.txt&query=keyword\"\n\n# Read clipboard\ncurl http://<windows-ip>:35182/clipboard\n\n# Write clipboard\ncurl -X PUT -H \"Content-Type: application/json\" \\\n  -d '{\"content\":\"Hello World\"}' http://<windows-ip>:35182/clipboard\n\n# Take screenshot\ncurl http://<windows-ip>:35182/screenshot\n\n# List windows\ncurl http://<windows-ip>:35182/windows\n\n# List processes\ncurl http://<windows-ip>:35182/processes\n\n# Execute command\ncurl -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"command\":\"echo Hello\"}' http://<windows-ip>:35182/execute\n\n# MCP: Initialize\ncurl -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}' \\\n  http://<windows-ip>:35182/mcp/initialize\n\n# MCP: List tools\ncurl -X POST -H \"Content-Type: application/json\" \\\n  -d '{}' http://<windows-ip>:35182/mcp/tools/list\n\n# MCP: Call tool\ncurl -X POST -H \"Content-Type: application/json\" \\\n  -d '{\"name\":\"list_windows\",\"arguments\":{}}' \\\n  http://<windows-ip>:35182/mcp/tools/call\n\n# Shutdown server\ncurl http://<windows-ip>:35182/exit\n\nIf you have multiple computers with WinBridgeAgent installed on your LAN, configure your MCP client to manage them:\n\n```json\n{\n    \"mcpServers\": {\n        \"winbridge-test\": {\n            \"url\": \"http://192.168.31.3:35182\",\n            \"description\": \"Test PC\"\n        },\n        \"winbridge-office\": {\n            \"url\": \"http://192.168.31.4:35182\",\n            \"description\": \"Office PC\"\n        }\n    }\n}\n```\n\nSee [Multi-Computer Setup Guide](docs/MULTI_COMPUTER_SETUP.md) for details.\n\n## Configuration\n\nA `config.json` file is auto-generated on first run:\n\n```json\n{\n    \"server_port\": 35182,\n    \"auto_port\": true,\n    \"listen_address\": \"0.0.0.0\",\n    \"language\": \"en\",\n    \"auto_startup\": false,\n    \"daemon_enabled\": true\n}\n```\n\n| Key | Description | Default |\n|-----|-------------|---------|\n| `server_port` | Server listen port | `35182` |\n| `auto_port` | Auto-select port if occupied | `true` |\n| `listen_address` | `0.0.0.0` (LAN) or `127.0.0.1` (local only) | `0.0.0.0` |\n| `language` | UI language (`en` / `zh-CN`) | `en` |\n| `auto_startup` | Start with Windows | `false` |\n| `daemon_enabled` | Enable daemon watchdog | `true` |\n\n## Building from Source\n\n### Prerequisites\n\n- macOS (Apple Silicon or Intel)\n- CMake 3.20+\n- MinGW-w64 cross-compilation toolchain\n\n### Install Dependencies\n\n```bash\nbrew install mingw-w64 cmake\n```\n\n### Build\n\n```bash\n# Build all architectures\n./scripts/build.sh\n\n# Or build a single architecture manually\nmkdir -p build/x64\ncd build/x64\ncmake ../.. -DCMAKE_TOOLCHAIN_FILE=../../toolchain-mingw-x64.cmake \\\n            -DCMAKE_BUILD_TYPE=Release\nmake -j$(sysctl -n hw.ncpu)\n```\n\n### Build Outputs\n\n- `build/x64/WinBridgeAgent.exe` — Windows x64\n- `build/x86/WinBridgeAgent.exe` — Windows x86\n- `build/arm64/WinBridgeAgent.exe` — Windows ARM64\n\n## Project Structure\n\n```text\n.\n├── CMakeLists.txt\n├── src/            # C++ source code\n├── include/        # Public headers\n├── resources/      # Runtime assets and templates\n├── scripts/        # Build, test, release scripts\n├── docs/           # Documentation\n├── tests/          # Test code\n├── third_party/    # Vendored dependencies\n└── build/          # Build outputs\n```\n\n## Security Notes\n\n- **Listen Address**: Setting `0.0.0.0` allows LAN access; use `127.0.0.1` for local-only\n- **Firewall**: Windows Firewall may block network access; add an exception if needed\n- **Protected Processes**: System-critical processes cannot be terminated (system, csrss.exe, winlogon.exe, etc.)\n- **Protected Directories**: System directories cannot be deleted (C:\\Windows, C:\\Program Files, etc.)\n- **Audit Log**: All operations are logged\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE).\n\nCopyright © 2026 WinBridgeAgent Contributors\n",
  "bytes": 14297,
  "sha": "86f5787a6fa1101f1c2b239138f762a4998323a2938d5e4e6168bf78d1539332",
  "repo_slug": "codyard/winbridgeagent",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_codyard_winbridgeagent_78da55b9/readme"
}