浏览器控制协议服务器

一个提供对Chrome开发者工具协议直接访问的最小化MCP服务器,用于灵活控制浏览器。

  • by Myestery
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Myestery/browser-cdp-mcp

使用说明

浏览器CDP MCP服务器

一个最小的MCP(模型上下文协议)服务器,提供对Chrome DevTools协议(CDP)的直接访问,以实现最大的浏览器控制灵活性。

特性

  • 原始CDP访问:直接通过以下方式调用任何Chrome DevTools Protocol方法 cdp_send
  • 电脑屏幕截图工具:以PNG或JPEG格式截取屏幕截图
  • URL检索:获取当前页面URL
  • 浏览器管理:启动和关闭浏览器实例

安装

npm install

用法

npm start

服务器使用MCP协议通过stdio进行通信。

工具

cdp_send

执行任何CDP方法。参考:https://chromedevtools.github.io/devtools-protocol/

参数:

  • method (string):CDP方法名称(例如。, Page.navigate, DOM.getDocument, Runtime.evaluate)
  • params (object,可选):CDP方法的参数

例子:

{
  "method": "Page.navigate",
  "params": { "url": "https://example.com" }
}

screenshot

捕获当前页面的屏幕截图。

参数:

  • format (字符串,可选): "png" 或 "jpeg" (默认值: "png")
  • fullPage (布尔值,可选):捕获完整的可滚动页面(默认值: false)

get_url

返回当前页面URL。

close_browser

关闭浏览器实例并清理资源。

MCP配置

添加到MCP客户端配置中:

claude mcp add-json browser '{
  "type": "stdio",
  "command": "node",
  "args": ["path/to/browser-tool/server.js"]
}' --scope user

技能整合

将浏览器技能添加到claude中:

cp .path/to/browser-tool/.claude/skills/browser.md ~/.claude/skills/browser.md

依赖项

  • @modelcontextprotocol/sdk -用于服务器实现的MCP SDK
  • playwright -浏览器自动化
  • zod -架构验证

许可证

麻省理工学院