[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_105":106},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","codyard","moduleId","winbridgeagent","@codyard/winbridgeagent","displayName","WinBridgeAgent","tagline","Open-source Windows MCP server for AI assistants. File, clipboard, screenshot, process & power mgmt.","iconKey","https://avatars.githubusercontent.com/u/260433569?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783338564000,"updatedAt",1788778397000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.codyard%2Fwinbridgeagent","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",12,"upstreamUpdatedAt",1774241946000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/codyard/WinBridgeAgent","githubRepoFullName","codyard/WinBridgeAgent","releaseId","ext-codyard-winbridgeagent","version","0.5.0","descriptionMarkdown","# 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[中文文档](https://github.com/codyard/WinBridgeAgent/blob/main/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`](https://github.com/codyard/WinBridgeAgent/blob/main/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 `` 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://: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://:35182`\n\nOr edit `.cursor/mcp.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"winbridgeagent\": {\n \"url\": \"http://: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://: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://:35182`\n\nFor a step-by-step Windows node deployment walkthrough (including `mcporter` pairing), see [`windows-node-install.en.md`](https://github.com/codyard/WinBridgeAgent/blob/main/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://: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://: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://: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=` | List directory contents |\n| GET | `/read?path=` | Read file content |\n| GET | `/search?path=&query=` | 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 `` 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://:35182/health\n\n# List disks\ncurl http://:35182/disks\n\n# List directory\ncurl \"http://:35182/list?path=C:\\\\\"\n\n# Read file\ncurl \"http://:35182/read?path=C:\\\\test.txt\"\n\n# Search file content\ncurl \"http://:35182/search?path=C:\\\\test.txt&query=keyword\"\n\n# Read clipboard\ncurl http://:35182/clipboard\n\n# Write clipboard\ncurl -X PUT -H \"Content-Type: application/json\" \\\n -d '{\"content\":\"Hello World\"}' http://:35182/clipboard\n\n# Take screenshot\ncurl http://:35182/screenshot\n\n# List windows\ncurl http://:35182/windows\n\n# List processes\ncurl http://:35182/processes\n\n# Execute command\ncurl -X POST -H \"Content-Type: application/json\" \\\n -d '{\"command\":\"echo Hello\"}' http://: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://:35182/mcp/initialize\n\n# MCP: List tools\ncurl -X POST -H \"Content-Type: application/json\" \\\n -d '{}' http://: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://:35182/mcp/tools/call\n\n# Shutdown server\ncurl http://: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](https://github.com/codyard/WinBridgeAgent/blob/main/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](https://github.com/codyard/WinBridgeAgent/blob/main/LICENSE).\n\nCopyright © 2026 WinBridgeAgent Contributors\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":-5,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":81,"_93":81},"ratingAvg","reviewCount","topics",[],"license","GPL-3.0","language","C++","registryName","io.github.codyard/winbridgeagent","homepage","packages",[],"ENV",{"_107":108,"_109":110,"_111":112},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]