WinBridgeAgent 的
WinBridgeAgent是一个开源的Windows本地功能服务，它实现了模型上下文协议（MCP）标准，为Claude Desktop、OpenAI等AI助手提供可追溯的Windows系统操作。
WinBridgeAgent Pro（免费下载）
除了开源版本之外， WinBridgeAgent Pro 的 现在可以免费下载。
Pro版专为需要更完整的Windows代理/节点体验的用户而设计，并不断改进以实现更适合生产的Windows节点（更接近OpenClaw节点体验）。
关键改进领域（正在进行中）包括：
- 更强的媒体功能：相机照片/视频捕捉和屏幕录制
- 更深入的系统集成：通知、位置、音频和相关操作系统功能
- 更强大的自动化：扩展了shell命令执行权限/安全控制
- 更好的生产准备：超时处理、资源清理、错误处理和稳定性工作
请点击此处查看详情并下载：
- https://codyard.dev/winbridgeagentpro
建筑
+------------------------------------------------------+
| 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)特性
核心
- MCP协议：完整的模型上下文协议实现
- UTF-8兼容性：MCP工具输出采用UTF-8编码，包括非ASCII Windows路径
- HTTP API：用于远程控制的HTTP接口
- 实时监控：带有实时请求/响应显示的仪表板窗口
- 审计日志：完整的操作日志记录
- 系统托盘：方便的图形化管理界面
- 灵活的配置：在0.0.0.0和127.0.0.1侦听地址之间切换
- 自动更新：一键下载自动检查GitHub发布
文件和系统操作
- 文件读取：磁盘枚举、目录列表、文件读取（行范围）、内容搜索
- 文件操作：删除、复制、移动、创建目录
- 剪贴板：通过HTTP API读取/写入剪贴板内容（文本、图像、文件）
- 截图:
- 全屏（HTTP API、PNG/JPEG） - 窗口捕获（MCP工具，按窗口标题） - 区域捕捉（MCP工具，按坐标）
流程和窗口管理
- 窗口管理：列出所有打开的窗口及其详细信息
- 处理查询：列出所有正在运行的进程及其详细信息
- 流程管理：终止进程，调整优先级（使用受保护的进程块列表）
- 命令执行：执行系统命令并捕获输出
电源管理
- 关机：延迟、强制、带有自定义消息
- 重启：延迟、被迫
- 休眠和睡眠：系统休眠和睡眠
- 取消关闭：取消计划的关机/重启
自动更新
- 版本检查：自动GitHub发布检查
- 更新通知：友好的通知对话框
- 一键下载：打开GitHub发布页面
- 多通道：稳定和Beta通道
- 多语言：简体中文、英文
系统要求
- Windows 10/11（x64、x86、ARM64）
- 无其他运行时依赖关系
快速开始
从MCP注册表安装
WinBridgeAgent发布于 MCP注册表 作为 io.github.codyard/winbridgeagent支持注册表的.MCP客户端可以直接安装它。
手动安装
- 从下载最新版本
- 跑
WinBridgeAgent-x64.exe（64位）或WinBridgeAgent-x86.exe（32位） - 程序出现在系统托盘中
- 配置您的MCP客户端（见下文）
有关OpenClaw+Windows节点设置，请参阅 .
MCP客户端配置
WinBridgeAgent适用于任何兼容MCP的客户端。以下是常见客户端的设置说明。
备注：替换 `运行WinBridgeAgent的Windows PC的IP地址（例如。192.168.1.100).使用localhost` 仅当MCP客户端在同一台Windows计算机上运行时。
克劳德桌面版
编辑 claude_desktop_config.json:
- 视窗:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"winbridgeagent": {
"url": "http://:35182",
"transport": "http"
}
}
}光标
- 打开 设置 → 主控程序
- 点击 添加新的MCP服务器
- 填写：
- 名字: winbridgeagent - 类型: http - 统一资源定位符: http://:35182
或编辑 .cursor/mcp.json 在项目根目录中：
{
"mcpServers": {
"winbridgeagent": {
"url": "http://:35182",
"transport": "http"
}
}
}帆板运动
编辑 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"winbridgeagent": {
"serverUrl": "http://:35182"
}
}
}开爪
- 打开 设置 → MCP服务器
- 点击 添加
- 设置：
- 名字: winbridgeagent - 运输: HTTP - 统一资源定位符: http://:35182
有关Windows节点部署的分步演练（包括 mcporter 配对），请参阅 .
樱桃工作室
- 打开 设置 → MCP服务器
- 点击 添加服务器
- 选择 可流式传输的HTTP 类型
- 将URL设置为
http://:35182
Cline（VS代码）
编辑 cline_mcp_settings.json 在VS代码设置中：
{
"mcpServers": {
"winbridgeagent": {
"url": "http://:35182",
"transportType": "http"
}
}
}通用MCP客户端
任何支持HTTP传输的MCP客户端都可以使用以下方式连接：
- 服务器URL:
http://:35182 - 运输：HTTP（流式HTTP）
- 协议版本:
2024-11-05
HTTP API
服务器监听配置的端口（默认35182）。
开源版：不需要承载令牌身份验证。所有API端点都可以直接访问。
端点
| 方法 | 路径 | 描述 |
|---|---|---|
| 得到 | / | API端点列表 |
| 得到 | /health | 健康检查 |
| 得到 | /status | 服务器状态和信息 |
| 得到 | /disks | 列出所有磁盘驱动器 |
| 得到 | `/list?path= | |
| ` | 列出目录内容 | |
| 得到 | `/read?path= | |
| ` | 读取文件内容 | |
| 得到 | `/search?path= | |
| &query=` | 搜索文件内容 | |
| 得到 | /clipboard | 读取剪贴板 |
| PUT | /clipboard | 写入剪贴板 |
| 得到 | /screenshot | 截图 |
| 得到 | /windows | 列出所有窗口 |
| 得到 | /processes | 列出所有流程 |
| 职位 | /execute | 执行命令 |
| 得到 | /exit | 关闭服务器 |
| 职位 | /mcp/initialize | MCP初始化 |
| 职位 | /mcp/tools/list | MCP列表工具 |
| 职位 | /mcp/tools/call | MCP呼叫工具 |
例子
替换 ` 下面是您的Windows PC的实际IP（或使用 localhost` 如果在同一台机器上进行测试）。# 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" } } }
看 [多计算机设置指南](docs/MULTI_COMPUTER_SETUP.md) 了解详情。
## 配置
A. `config.json` 文件在首次运行时自动生成：
{ "server_port": 35182, "auto_port": true, "listen_address": "0.0.0.0", "language": "en", "auto_startup": false, "daemon_enabled": true }
|关键字|描述|默认值|
|-----|-------------|---------|
| `server_port` |服务器侦听端口| `35182` |
| `auto_port` |如果端口被占用，则自动选择端口| `true` |
| `listen_address` | `0.0.0.0` （局域网）或 `127.0.0.1` （仅限本地）| `0.0.0.0` |
| `language` |UI语言(`en` / `zh-CN`) | `en` |
| `auto_startup` |从Windows开始| `false` |
| `daemon_enabled` |启用守护程序监视器| `true` |
## 从源头构建
### 先决条件
- macOS（苹果硅或英特尔）
- CMake 3.20+
- MinGW-w64交叉编译工具链
### 再进行
brew install mingw-w64 cmake
### 构建
Build all architectures
./scripts/build.sh
Or build a single architecture manually
mkdir -p build/x64 cd build/x64 cmake ../.. -DCMAKE_TOOLCHAIN_FILE=../../toolchain-mingw-x64.cmake \ -DCMAKE_BUILD_TYPE=Release make -j$(sysctl -n hw.ncpu)
### 构建输出
- `build/x64/WinBridgeAgent.exe` --Windows x64
- `build/x86/WinBridgeAgent.exe` --Windows x86
- `build/arm64/WinBridgeAgent.exe` --Windows ARM64
## 项目结构
. ├── CMakeLists.txt ├── src/ # C++ source code ├── include/ # Public headers ├── resources/ # Runtime assets and templates ├── scripts/ # Build, test, release scripts ├── docs/ # Documentation ├── tests/ # Test code ├── third_party/ # Vendored dependencies └── build/ # Build outputs
## 安全说明
- **侦听地址**：设置 `0.0.0.0` 允许局域网接入；使用 `127.0.0.1` 仅限本地
- **防火墙**：Windows防火墙可能会阻止网络访问；如果需要，添加例外
- **受保护的进程**：无法终止系统关键进程（系统、csrss.exe、winlogon.exe等）
- **受保护的目录**：无法删除系统目录（C:\\Windows、C:\\Program Files等）
- **审计日志**：记录所有操作
## 许可证
该项目根据 [GNU通用公共许可证v3.0](LICENSE).
版权所有©2026 WinBridgeAgent贡献者