A simple MCP Server for controlling Chrome via Puppeteer

A simple MCP Server for controlling Chrome via Puppeteer

site icon
2025.04.22 0
TypeScript浏览器控制自动化测试浏览器自动化
mcp-puppeteer 是一个简单的 MCP 服务器,用于通过 Puppeteer 控制 Chrome 浏览器。它基于 `puppeteer-core`,不安装额外的浏览器,要求用户自行启动 Chrome 并启用远程调试端口。
View on GitHub

Overview

基本能力

产品定位

mcp-puppeteer 是一个用于控制 Chrome 浏览器的 MCP 服务器,适用于需要通过 Puppeteer 进行浏览器自动化的场景。

核心功能

  • 通过 Puppeteer 控制 Chrome 浏览器。
  • 支持远程调试端口配置。
  • 提供 SSE(Server-Sent Events)支持。

适用场景

  • 浏览器自动化测试。
  • 网页内容抓取或监控。
  • 需要与 Chrome 浏览器交互的开发任务。

工具列表

  • Inspector:用于调试和监控 MCP 服务器的工具,可以通过 pnpx @modelcontextprotocol/inspector 启动。

常见问题解答

  1. 如何启动 Chrome 并启用远程调试端口? 在 Mac 上,可以使用以下命令: sh open -a "Google Chrome" --args --remote-debugging-port=9222
  2. 如何配置 Cursor 以使用 mcp-puppeteer? 在 Cursor 的设置中添加以下配置: json { "mcpServers": { "puppeteer-control": { "url": "http://localhost:7742/sse" } } }

使用教程

使用依赖

  1. 确保已安装 Node.js 和 pnpm。
  2. 启动 Chrome 并启用远程调试端口: sh open -a "Google Chrome" --args --remote-debugging-port=9222

安装教程

  1. 安装依赖: sh pnpm i
  2. 运行 MCP 服务器: sh pnpm run start

调试方式

  1. 确保 MCP 服务器已运行并使用 SSE。
  2. 启动 Inspector: sh pnpx @modelcontextprotocol/inspector

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。