AI导哈

Windows本地能力服务

WinBridgeAgent是一款实现模型上下文协议（MCP）标准的开源Windows本地能力服务，为AI助手提供可追溯的Windows系统操作。

  • by codyard
  • C++
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 codyard/WinBridgeAgent

使用说明

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客户端可以直接安装它。

手动安装

  1. 从下载最新版本 GitHub发布
  2. 跑 WinBridgeAgent-x64.exe （64位）或 WinBridgeAgent-x86.exe （32位）
  3. 程序出现在系统托盘中
  4. 配置您的MCP客户端（见下文）

有关OpenClaw+Windows节点设置，请参阅 windows-node-install.en.md.

MCP客户端配置

WinBridgeAgent适用于任何兼容MCP的客户端。以下是常见客户端的设置说明。

备注：替换 <windows-ip> 运行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://<windows-ip>:35182",
            "transport": "http"
        }
    }
}

光标

  1. 打开 设置 → 主控程序
  2. 点击 添加新的MCP服务器
  3. 填写：
    • 名字: winbridgeagent
    • 类型: http
    • 统一资源定位符: http://<windows-ip>:35182

或编辑 .cursor/mcp.json 在项目根目录中：

{
    "mcpServers": {
        "winbridgeagent": {
            "url": "http://<windows-ip>:35182",
            "transport": "http"
        }
    }
}

帆板运动

编辑 ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "winbridgeagent": {
            "serverUrl": "http://<windows-ip>:35182"
        }
    }
}

开爪

  1. 打开 设置 → MCP服务器
  2. 点击 添加
  3. 设置：
    • 名字: winbridgeagent
    • 运输: HTTP
    • 统一资源定位符: http://<windows-ip>:35182

有关Windows节点部署的分步演练（包括 mcporter 配对），请参阅 windows-node-install.en.md.

樱桃工作室

  1. 打开 设置 → MCP服务器
  2. 点击 添加服务器
  3. 选择 可流式传输的HTTP 类型
  4. 将URL设置为 http://<windows-ip>:35182

Cline（VS代码）

编辑 cline_mcp_settings.json 在VS代码设置中：

{
    "mcpServers": {
        "winbridgeagent": {
            "url": "http://<windows-ip>:35182",
            "transportType": "http"
        }
    }
}

通用MCP客户端

任何支持HTTP传输的MCP客户端都可以使用以下方式连接：

  • 服务器URL: http://<windows-ip>:35182
  • 运输：HTTP（流式HTTP）
  • 协议版本: 2024-11-05

HTTP API

服务器监听配置的端口（默认35182）。

开源版：不需要承载令牌身份验证。所有API端点都可以直接访问。

端点

方法 路径 描述
得到 / API端点列表
得到 /health 健康检查
得到 /status 服务器状态和信息
得到 /disks 列出所有磁盘驱动器
得到 /list?path=<path> 列出目录内容
得到 /read?path=<path> 读取文件内容
得到 /search?path=<path>&query=<q> 搜索文件内容
得到 /clipboard 读取剪贴板
PUT /clipboard 写入剪贴板
得到 /screenshot 截图
得到 /windows 列出所有窗口
得到 /processes 列出所有流程
职位 /execute 执行命令
得到 /exit 关闭服务器
职位 /mcp/initialize MCP初始化
职位 /mcp/tools/list MCP列表工具
职位 /mcp/tools/call MCP呼叫工具

例子

替换 <windows-ip> 下面是您的Windows PC的实际IP（或使用 localhost 如果在同一台机器上进行测试）。

# Server status
curl http://<windows-ip>:35182/health

# List disks
curl http://<windows-ip>:35182/disks

# List directory
curl "http://<windows-ip>:35182/list?path=C:\\"

# Read file
curl "http://<windows-ip>:35182/read?path=C:\\test.txt"

# Search file content
curl "http://<windows-ip>:35182/search?path=C:\\test.txt&query=keyword"

# Read clipboard
curl http://<windows-ip>:35182/clipboard

# Write clipboard
curl -X PUT -H "Content-Type: application/json" \
  -d '{"content":"Hello World"}' http://<windows-ip>:35182/clipboard

# Take screenshot
curl http://<windows-ip>:35182/screenshot

# List windows
curl http://<windows-ip>:35182/windows

# List processes
curl http://<windows-ip>:35182/processes

# Execute command
curl -X POST -H "Content-Type: application/json" \
  -d '{"command":"echo Hello"}' http://<windows-ip>: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://<windows-ip>:35182/mcp/initialize

# MCP: List tools
curl -X POST -H "Content-Type: application/json" \
  -d '{}' http://<windows-ip>:35182/mcp/tools/list

# MCP: Call tool
curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"list_windows","arguments":{}}' \
  http://<windows-ip>:35182/mcp/tools/call

# Shutdown server
curl http://<windows-ip>:35182/exit

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

```json
{
    "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"
        }
    }
}

看 多计算机设置指南 了解详情。

配置

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.

版权所有©2026 WinBridgeAgent贡献者

相关 MCP