快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

python local_agent.py

详细介绍

🌉 桥接MCP

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

![FastMCP](https://fastmcp.cloud) ![License](LICENSE) ![Python](https://python.org) ![Windows](https://www.microsoft.com/windows)

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

特性 • 快速开始 • 配置 • 工具 • 故障排除 • 贡献

______________________________________________________________________

🔄 毅力是如何发挥作用的

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

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

这意味着：

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

首次设置

启动本地代理：

   cd Bridge-MCP
   python local_agent.py

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

在任何Claude会话中验证：

   Use list_agents() to see registered agents

故障排除

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

检查local_agent.py是否正在运行 -它必须在终端中运行
检查健康状况： 使用 check_agent_health() 工具
手动登记： 使用 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")等等。

______________________________________________________________________

🔧 配置

克劳德桌面版

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

添加桥接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

完全重新启动克劳德桌面 （关闭并重新打开）

光标

使用相同的配置格式在光标首选项中添加到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显示“服务器已断开连接”

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

手动测试 -打开命令提示符并运行：

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

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

安装依赖项:

   pip install fastmcp httpx

重新启动克劳德桌面 -在任何配置更改后完全关闭并重新打开。

本地代理未接收到命令

确保 local_agent.py 正在终端中运行（保持打开！）
注册代理时验证回调URL是否正确
供本地使用： http://127.0.0.1:8006
远程访问：使用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云为了便于访问：

分叉此存储库
首选 fastmcp.cloud
使用GitHub登录
从您的分叉仓库创建项目
设置入口点： bridge_mcp.py
部署！

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

______________________________________________________________________

🤝 贡献

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

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

贡献的想法

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

______________________________________________________________________

📜 许可证

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

______________________________________________________________________

🙏 致谢

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

______________________________________________________________________

👤 作者

巴勒姆·阿加

github： @巴勒姆·阿加1

______________________________________________________________________

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

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

目录标签

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

支持客户端

Claude DesktopClaudeCursor

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

session

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdiosession部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/08966775555da5fe7a16d9050f0aa101

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

BR

AIBase MCP

mcp.aibase.com

/zh/server/1639702865805320304

全面解析Bridge MCPMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Bridge MCP能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

继续浏览同类 MCP

更多浏览器工具 MCP（2,803）返回 MCP 目录

上一个 MCP

Brewpage MCP

Publish HTML, Markdown, KV, JSON, and files to brewpage.app from AI assistants. 5 tools, stdio, no signup. Returns public short URL + owner token per artifact.

下一个 MCP

Bright 20data 20mcp

Discover, extract, and interact with the web - one interface powering automated access across the public internet.