Browser CDP MCP Server

浏览器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 -架构验证

许可证

麻省理工学院