AI导哈

AI PC控制工具

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

  • by BarhamAgha1
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 BarhamAgha1/Bridge-MCP

使用说明

🌉 桥接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. 启动本地代理：
   cd Bridge-MCP
   python local_agent.py

  1. 代理自动注册自己 -无需手动注册！

  2. 在任何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服务安装：

python install_service.py install
python install_service.py start

要删除：

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：克隆存储库

git clone https://github.com/BarhamAgha1/Bridge-MCP.git
cd Bridge-MCP

步骤2：安装依赖项

pip install -r requirements-local.txt

注： Playwright浏览器（约100MB）在首次使用时自动安装，无需手动设置！

步骤3：启动本地代理

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：

{
  "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
  1. 完全重新启动克劳德桌面 （关闭并重新打开）

光标

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

VS代码+克劳德代码

创建 .vscode/mcp.json 在您的项目中：

{
  "mcpServers": {
    "bridge-mcp": {
      "command": "python",
      "args": ["C:\\Users\\YourName\\Path\\To\\Bridge-MCP\\bridge_mcp.py"]
    }
  }
}

远程访问（可选）

要从任何地方控制您的电脑，请使用ngrok暴露本地代理：

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. 手动测试 -打开命令提示符并运行：

   cd "C:\path\to\Bridge-MCP"
   python bridge_mcp.py

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

  1. 安装依赖项:
   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许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

👤 作者

巴勒姆·阿加

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

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

相关 MCP