WinBridgeAgent

Name: WinBridgeAgent
Author: codyard

本地服务

github.com/codyard生产力1331 周前更新

代码仓库

关于 WinBridgeAgent

WinBridgeAgent 是面向 Windows AI 助手的开源本地能力服务，支持文件、剪贴板、截图、进程和电源操作。它通过 HTTP 提供 MCP 连接，也具备实时操作监控和审计日志。

主要功能

01文件读取、搜索与管理
02剪贴板读写
03屏幕、窗口和区域截图
04窗口与进程管理
05命令执行和电源控制
06实时监控与审计日志

适用场景

01让 AI 助手读取或整理本地文件
02通过 MCP 获取屏幕或窗口截图
03查询进程并终止受支持的进程
04从远程客户端调用 Windows 操作

MCP 相关

该服务实现 MCP，并通过 HTTP（Streamable HTTP）连接兼容客户端，默认监听端口为 35182。它向客户端提供 Windows 文件、剪贴板、截图、进程和系统操作能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

WinBridgeAgent

中文文档

WinBridgeAgent 是一款开源的 Windows 本地能力服务，实现了 Model Context Protocol（MCP）标准，可为 Claude Desktop、OpenAI 等 AI 助手提供可追溯的 Windows 系统操作。

WinBridgeAgent Pro（免费下载）

除开源版外，WinBridgeAgent Pro 现已提供免费下载。

Pro 版面向需要更完整 Windows Agent/Node 体验的用户，并持续改进，力求打造更适合生产环境的 Windows 节点（更接近 OpenClaw Node 的体验）。

持续增强的重点领域包括：

更强大的媒体能力：摄像头拍照/录像和屏幕录制
更深入的系统集成：通知、位置、音频及相关 OS 功能
更强大的自动化：扩展 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 协议：完整实现 Model Context Protocol
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 Release 页面
多渠道：稳定版和 Beta 渠道
多语言：简体中文、英语

系统要求

Windows 10/11（x64、x86、ARM64）
无需额外的运行时依赖

快速开始

从 MCP Registry 安装

WinBridgeAgent 已发布到 MCP Registry，名称为 io.github.codyard/winbridgeagent。支持该注册表的 MCP 客户端可以直接安装。

手动安装

从 GitHub Releases 下载最新版本
运行 WinBridgeAgent-x64.exe（64 位）或 WinBridgeAgent-x86.exe（32 位）
程序会显示在系统托盘中
配置 MCP 客户端（见下文）

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

MCP 客户端配置

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

注意：将 <windows-ip> 替换为运行 WinBridgeAgent 的 Windows 电脑的 IP 地址（例如 192.168.1.100）。只有当 MCP 客户端在同一台 Windows 电脑上运行时，才使用 localhost。

Claude Desktop

编辑 claude_desktop_config.json：

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

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

Cursor

打开设置 → MCP
点击 添加新的 MCP 服务
填写：
- 名称：winbridgeagent
- 类型：http
- URL：http://<windows-ip>:35182

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

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

Windsurf

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

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

OpenClaw

打开设置 → MCP 服务
点击添加
设置：
- 名称：winbridgeagent
- 传输方式：HTTP
- URL：http://<windows-ip>:35182

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

Cherry Studio

打开设置 → MCP 服务
点击 添加服务
选择 Streamable HTTP 类型
将 URL 设置为 http://<windows-ip>:35182

Cline（VS Code）

在 VS Code 设置中编辑 cline_mcp_settings.json：

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

通用 MCP 客户端

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

服务 URL：http://<windows-ip>:35182
传输方式：HTTP（Streamable HTTP）
协议版本：2024-11-05

HTTP API

服务在配置的端口上侦听（默认端口为 35182）。

开源版：无需 Bearer Token 身份验证。所有 API 端点均可直接访问。

端点

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

示例

将下方的 <windows-ip> 替换为 Windows 电脑的实际 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"
        }
    }
}

详情请参阅多电脑设置指南。

配置

首次运行时会自动生成 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（Apple Silicon 或 Intel）
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 防火墙可能会阻止网络访问；必要时请添加例外
受保护的进程：无法终止对系统至关重要的进程（system、csrss.exe、winlogon.exe 等）
受保护的目录：无法删除系统目录（C:\Windows、C:\Program Files 等）
审计日志：所有操作都会记录到日志中

许可证

本项目采用 GNU 通用公共许可证第 3 版授权。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

WinBridgeAgent

关于 WinBridgeAgent

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

WinBridgeAgent

WinBridgeAgent Pro（免费下载）

架构

功能

核心功能

文件与系统操作

进程与窗口管理

电源管理

自动更新

系统要求

快速开始

从 MCP Registry 安装

手动安装

MCP 客户端配置

Claude Desktop

Cursor

Windsurf

OpenClaw

Cherry Studio

Cline（VS Code）

通用 MCP 客户端

HTTP API

端点

示例

配置

从源代码构建

前置条件

安装依赖项

构建

构建产物

项目结构

安全说明

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？