Bridge MCP

MCP浏览器工具

提供方 BarhamAgha1

浏览器工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Bridge MCP是一款允许AI通过Model Context Protocol(MCP)完全控制Windows PC的工具,提供应用程序控制、输入自动化、屏幕捕获、系统命令执行等功能。

一句话选型结论

按资料字段整理

Bridge MCP 属于浏览器工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI自动化Python本地部署Windows控制PC自动化浏览器自动化系统管理

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
python local_agent.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Bridge MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方BarhamAgha1上游标注的维护方 BarhamAgha1
分类浏览器工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.3 KB
来自项目仓库与上游目录的原文,未做删改

🌉 桥接MCP

适用于任何AI的通用PC控制

让任何AI完全控制你的Windows PC


🔄 毅力是如何发挥作用的

Bridge MCP v2.0将代理注册存储在 持久JSON文件:

  • 窗户: %APPDATA%\bridge-mcp\agents.json
  • Linux/Mac: ~/.config/bridge-mcp/agents.json

这意味着:

  • ✅ 注册一次,永远有效
  • ✅ 克劳德代码会话重启后幸存
  • ✅ 计算机重新启动后仍能存活
  • ✅ 适用于所有AI客户端

首次设置

  1. 启动本地代理:```bash
    cd Bridge-MCP
    python local_agent.py

2. **代理自动注册自己** -无需手动注册!

1. **在任何Claude会话中验证:**```
Use list_agents() to see registered agents

故障排除

如果您看到“未连接代理”:

  1. 检查local_agent.py是否正在运行 -它必须在终端中运行
  2. 检查健康状况: 使用 check_agent_health() 工具
  3. 手动登记: 使用 register_agent("local", "http://127.0.0.1:8006", "My PC")

将本地代理作为后台服务运行

要始终在线访问,请将local_agent作为Windows服务安装:```bash
python install_service.py install
python install_service.py start


要删除:```bash
python install_service.py stop
python install_service.py remove

🎯 什么是桥接MCP?

桥接MCP是一种 模型上下文协议(MCP) 服务器提供 任何AI 完全控制Windows PC。无论您使用的是Claude、ChatGPT、Cursor、Gemini还是任何其他兼容MCP的AI,Bridge MCP都可以让您:

  • 🖥️ 控制应用 -启动、切换、调整大小、关闭任何应用程序
  • 🖱️ 自动化输入 -鼠标点击、键盘打字、热键、滚动
  • 📸 查看屏幕 -截图、UI元素检测、桌面状态
  • 🌐 浏览网页 -完全的Chrome自动化和控制
  • ⚡ 运行命令 -PowerShell、CMD、文件操作
  • 📋 管理剪贴板 -复制、粘贴、清除

> 把它想象成让你的人工智能眼睛和手来控制你的电脑!


✨ 特性

类别 工具 描述
🚀 应用程序控制 8个工具 启动、切换、关闭、调整大小、最小化、最大化应用程序
🖱️ 鼠标和键盘 10个工具 单击、键入、热键、滚动、拖动、移动光标
📸 屏幕截图 7个工具 截图、桌面状态、查找UI元素
⚡ 系统 8个工具 PowerShell、CMD、文件读/写、系统信息
🌐 浏览器 15个工具 Chrome控件、标签、导航、网页抓取
📋 剪贴板 3个工具 复制、粘贴、清除剪贴板
🔧 公用事业 5+工具 等待、对话框、动作序列

总计:40多个强大的工具,用于实现完全的PC自动化!


🏗️ 建筑

桥接MCP使用 中继架构 跨平台工作:```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Any AI │ │ Cloud Relay │ │ Your Windows │
│ (Claude, etc.) │◄───────►│ (bridge_mcp) │◄───────►│ PC (Agent) │
└─────────────────┘ └─────────────────┘ └─────────────────┘


- **bridge_mcp.py** -MCP服务器(在本地或FastMCP云上运行)
- **local_agent.py** -PC上执行命令的HTTP服务器(端口8006)

______________________________________________________________________

## 🔒 企业级安全

桥接MCP 2.0包括:

- **身份验证令牌:** 使用安全的承载令牌来防止未经授权的访问。
- **自动配置:** 令牌会自动生成并保存到 `agents.json`.

## 🌐 下一代浏览器自动化

由...驱动 **剧作家**,桥接MCP现在可以:

- **单击并键入:** 与任何网站元素交互。
- **语义理解:** 以编程方式读取页面内容。
- **无头模式:** 运行不可见或可见的自动化。

## 🧠 语义计算机视觉

Bridge MCP“看到”您的应用程序:

- **UI树:** 它可以读取Windows应用程序的可访问性树。
- **精度:** 知道按钮的确切位置(不再猜测像素)。

## 🛡️ 安全哨兵(人在环)

Bridge MCP现在让您掌控一切:

- **命令拦截:** 默认情况下,危险命令(写入文件、运行shell脚本)被阻止。
- **批准覆盖:** 审批请求直接出现在AI活动覆盖中,有三个选项:
- ✓ **批准** -执行此命令
- ✗ **拒绝** -阻止此命令
- ✓ **始终批准** -禁用安全模式并批准所有未来的命令
- **仪表板控制:** 查看所有待处理的请求 `http://localhost:8006`
- **安全模式切换:** 随时从网络仪表板打开/关闭安全模式
- **安心:** 您可以让代理运行,而不用担心它会删除您的文件。

## 👁️ 终结者视觉(实时可观察性)

实时查看AI看到的内容:

- **直播流:** 仪表板具有桌面的低延迟1080p MJPEG流。
- **语义叠加:** 绿色边界框突出显示AI检测到的每个按钮、链接和窗口。
- **立即调试:** 视觉确认AI已找到正确的“提交”按钮。

## 📚 完整的MCP规范支持

Bridge MCP现在实现了完整的模型上下文协议规范:

### 资源API

将桌面数据作为可寻址资源公开:

- `desktop://screenshot/latest` -当前截图
- `desktop://windows` -打开窗口列表
- `desktop://logs` -代理命令日志
- `file:///{path}` -读取任何桌面文件
- `desktop://session/context` -最近的会话历史

### 提示API

用于一键自动化的预构建工作流模板:

- `automate_desktop_task` -逐步实现任务自动化
- `debug_error` -交互式错误调试
- `web_automation` -剧作家网络工作流程

### 会话内存

永远不要失去上下文:

- 在重启过程中存储最后100个命令
- 为AI提供最近的会话历史记录
- 启用“从我停止的地方继续”工作流

______________________________________________________________________

## 🚀 快速开始

### 步骤1:克隆存储库```bash
git clone https://github.com/BarhamAgha1/Bridge-MCP.git
cd Bridge-MCP

步骤2:安装依赖项```bash

pip install -r requirements-local.txt


**注:** Playwright浏览器(约100MB)在首次使用时自动安装,无需手动设置!

### 步骤3:启动本地代理```bash
python local_agent.py

保持这个终端打开!代理将显示:```
Bridge MCP Local Agent running on http://127.0.0.1:8006


### 步骤4:配置您的AI客户端

看 配置 下面是克劳德桌面、光标或VS代码设置。

### 步骤5:注册您的代理

在您的AI对话中,注册本地代理:```
Use register_agent with:
- agent_id: "my-pc"
- callback_url: "http://127.0.0.1:8006"
- agent_name: "My Windows PC"

第六步:开始控制!

现在使用任何工具,如 screenshot(), click(100, 200), type_text("Hello"), app_launch("notepad")等等。


🔧 配置

克劳德桌面版

  1. 打开配置文件 %APPDATA%\Claude\claude_desktop_config.json

  2. 添加桥接MCP:```json
    {
    "mcpServers": {
    "bridge-mcp": {
    "command": "python",
    "args": ["C:\Users\YourName\Path\To\Bridge-MCP\bridge_mcp.py"]
    }
    }
    }


⚠️ **重要提示:** 将路径替换为 **实际位置** 你在哪里克隆了存储库!

**示例路径:**

- `C:\\Users\\PC\\Desktop\\Bridge-MCP\\bridge_mcp.py`
- `D:\\Projects\\Bridge-MCP\\bridge_mcp.py`

3. **完全重新启动克劳德桌面** (关闭并重新打开)

### 光标

使用相同的配置格式在光标首选项中添加到MCP设置中。

### VS代码+克劳德代码

创建 `.vscode/mcp.json` 在您的项目中:```json
{
"mcpServers": {
"bridge-mcp": {
"command": "python",
"args": ["C:\\Users\\YourName\\Path\\To\\Bridge-MCP\\bridge_mcp.py"]
}
}
}

远程访问(可选)

要从任何地方控制您的电脑,请使用ngrok暴露本地代理:```bash
ngrok http 8006


然后使用ngrok URL(例如。, `https://xxxx.ngrok.io`)注册时作为您的callback_url。

______________________________________________________________________

## 🛠️ 可用工具

🚀 App Control Tools

|工具|说明|示例|
| --- | --- | --- |
| `app_launch` |启动应用程序| `app_launch("notepad")` |
| `app_switch` |切换到打开应用程序| `app_switch("Chrome")` |
| `app_close` |关闭应用程序| `app_close("notepad")` |
| `app_list` |列出所有打开的应用程序| `app_list()` |

🖱️ Input Tools (Mouse & Keyboard)

|工具|说明|示例|
| --- | --- | --- |
| `click` |点击坐标| `click(500, 300)` |
| `double_click` |双击| `double_click(500, 300)` |
| `right_click` |右键单击| `right_click(500, 300)` |
| `type_text` |键入文本| `type_text("Hello World!")` |
| `press_key` |按一个键| `press_key("enter")` |
| `hotkey` |键盘快捷键| `hotkey("ctrl,c")` |
| `scroll` |滚动| `scroll("down", 3)` |
| `drag` |拖放| `drag(100, 100, 500, 500)` |
| `move_mouse` |移动光标| `move_mouse(500, 300)` |

📸 Screen Tools

|工具|说明|示例|
| --- | --- | --- |
| `screenshot` |截图| `screenshot()` |
| `get_desktop_state` |获取完整桌面状态| `get_desktop_state()` |
| `get_screen_size` |获取屏幕尺寸| `get_screen_size()` |
| `get_mouse_position` |获取光标位置| `get_mouse_position()` |

⚡ System Tools

|工具|说明|示例|
| --- | --- | --- |
| `run_powershell` |运行PowerShell| `run_powershell("Get-Process")` |
| `run_cmd` |运行CMD命令| `run_cmd("dir")` |
| `file_read` |读取文件| `file_read("C:/test.txt")` |
| `file_write` |写入文件| `file_write("C:/test.txt", "Hello")` |
| `file_list` |列表目录| `file_list("C:/Users")` |

🌐 Browser Tools (Chrome)

|工具|说明|示例|
| --- | --- | --- |
| `chrome_open` |打开Chrome浏览器| `chrome_open("https://google.com")` |
| `chrome_navigate` |转到URL| `chrome_navigate("https://example.com")` |

🌐 Browser Tools (Playwright - Advanced)

|工具|说明|示例|
| --- | --- | --- |
| `browser_navigate` |转到URL| `browser_navigate("google.com")` |
| `browser_click` |点击元素(CSS)| `browser_click("#submit-btn")` |
| `browser_type` |键入元素| `browser_type("#search", "hello")` |
| `browser_press` |按键| `browser_press("Enter")` |
| `browser_content` |获取页面文本| `browser_content()` |
| `browser_screenshot`|浏览器截图| `browser_screenshot()` |

📋 Clipboard Tools

|工具|说明|示例|
| --- | --- | --- |
| `clipboard_copy` |复制到剪贴板| `clipboard_copy("Hello")` |
| `clipboard_paste` |获取剪贴板| `clipboard_paste()` |

______________________________________________________________________

## 💡 使用示例

### 示例1:打开记事本并写入文本```
User: Open notepad and write "Hello from AI!"

AI uses:
1. app_launch("notepad")
2. wait(1)
3. type_text("Hello from AI!")

示例2:截图```

User: What's on my screen right now?

AI uses:
1. screenshot()
2. [AI analyzes the image and describes what it sees]


### 示例3:在谷歌上搜索```
User: Search for "Bridge MCP" on Google

AI uses:
1. chrome_open("https://google.com")
2. type_text("Bridge MCP")
3. press_key("enter")

🔧 故障排除

Claude Desktop显示“服务器已断开连接”

  1. 检查路径 -确保配置中的路径指向实际路径 bridge_mcp.py 文件。路径必须是绝对的,并使用双反斜杠(\\)JSON格式。

  2. 手动测试 -打开命令提示符并运行:```cmd
    cd "C:\path\to\Bridge-MCP"
    python bridge_mcp.py


它应该保持运行(不要立即退出)。按Ctrl+C停止。

3. **安装依赖项**:```cmd
pip install fastmcp httpx
  1. 重新启动克劳德桌面 -在任何配置更改后完全关闭并重新打开。

本地代理未接收到命令

  1. 确保 local_agent.py 正在终端中运行(保持打开!)
  2. 注册代理时验证回调URL是否正确
  3. 供本地使用: http://127.0.0.1:8006
  4. 远程访问:使用ngrok(ngrok http 8006)并使用ngrok URL

“未连接代理”错误

您需要先注册您的本地代理商:register_agent("my-pc", "http://127.0.0.1:8006", "My PC")

Windows上的Unicode/表情符号错误

如果 local_agent.py 由于Unicode错误而崩溃,终端可能不支持表情符号。此问题已在最新版本中修复。


☁️ FastMCP云部署

桥接MCP可以部署在 FastMCP云 为了便于访问:

  1. 分叉此存储库
  2. 首选 fastmcp.cloud
  3. 使用GitHub登录
  4. 从您的分叉仓库创建项目
  5. 设置入口点: bridge_mcp.py
  6. 部署!

您的MCP将在以下网址提供: https://your-project.fastmcp.app/mcp


🤝 贡献

欢迎投稿!以下是您可以提供帮助的方式:

  1. 分叉 存储库
  2. 创建 特征分支(git checkout -b feature/amazing-feature)
  3. 提交 您的更改(git commit -m 'Add amazing feature')
  4. 推 到分行(git push origin feature/amazing-feature)
  5. 打开 拉取请求

贡献的想法

  • 添加更多浏览器支持(Firefox、Edge)
  • 添加Linux支持
  • 添加macOS支持
  • 添加更多自动化工具
  • 改进UI元素检测
  • 添加OCR功能

📜 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。


🙏 致谢

  • FastMCP -令人惊叹的MCP框架
  • Anthropic -用于创建MCP协议

👤 作者

巴勒姆·阿加

  • github: @巴勒姆·阿加1

⭐ 如果你觉得这个项目有用,请给它一颗星! ⭐

由...制作❤️ 对于AI社区

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Bridge MCP 怎么安装?

在客户端按下面的安装命令接入:python local_agent.py。装完在客户端配置里引用同一个包或端点。

Bridge MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Bridge MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Bridge MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Bridge MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Bridge MCP 能提供哪些能力?

资料显示能力标签包括 AI自动化、浏览器自动化、Python、Claude、系统管理。具体工具清单以官方文档为准。

Bridge MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Bridge MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。