devbridge-mcp

English

通用浏览器调试 MCP 服务器。兼容任意支持 MCP 协议的 AI Agent—— Claude Code、Cline、Cursor、Windsurf 等均可直接使用。

快速开始

1. 安装浏览器扩展

从 Chrome 应用商店 安装 DevBridge 扩展。

支持 Chrome、Edge、Brave、Arc 及所有基于 Chromium 的浏览器。

2. 配置 AI Agent

Claude Code — 在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "devbridge": {
      "command": "npx",
      "args": ["-y", "devbridge-mcp@latest"]
    }
  }
}

Cline (VS Code) — 在设置中添加：

{
  "cline.mcpServers": {
    "devbridge": {
      "command": "npx",
      "args": ["-y", "devbridge-mcp@latest"]
    }
  }
}

3. 开始使用

在 AI Agent 中输入：

请帮我打开 https://example.com 并截图

功能

• 📄 读取页面内容、DOM 结构和无障碍树
• 🖱️ 点击、输入、滚动、拖拽、悬停和键盘快捷键
• 🖼️ 跨源 iframe 和 closed Shadow DOM 完整访问
• 🎨 Canvas 交互（点击、绘制、手势、像素检测）
• 📝 智能表单填充，兼容 React 受控组件
• 💻 执行 JavaScript，支持 50 KB 输出捕获
• 📸 截图和 GIF 录制
• 🔍 监控控制台日志和网络请求
• 🗂️ 多标签页管理，支持会话分组
• 🪟 调整浏览器窗口大小

共 25 个工具。完整工具参考：devbridge-mcp.pages.dev

系统要求

• Node.js: 22.0.0 或更高
• 浏览器: Chrome / Edge / Brave / Chromium (Stable)
• 操作系统: Windows 10+, macOS 10.15+, Linux (Ubuntu 20.04+)

故障排查

无法连接到浏览器？

1. 确认扩展已安装并启用（chrome://extensions）
2. 重启浏览器和 MCP 服务器

Node.js 版本过低？

node --version  # 需要 >= 22.0.0

Windows 权限错误？

首次运行时以管理员身份启动一次。

更多问题请参阅故障排查文档。

相关链接

• 官方文档
• Chrome 应用商店

许可证

AGPL-3.0 - 详见 LICENSE。