Configurable Puppeteer MCP Server
Overview
基本能力
产品定位
mcp-configurable-puppeteer 是一个浏览器自动化工具，旨在为开发者和 LLMs 提供灵活的网页交互能力。
核心功能
- 浏览器自动化：支持导航、点击、悬停、填写表单等基本网页操作。
- 截图功能：可以捕获整个页面或特定元素的截图。
- JavaScript 执行：允许在浏览器控制台中执行自定义 JavaScript 代码。
- 控制台日志监控：提供浏览器控制台输出的实时监控。
- 可配置性：通过环境变量
PUPPETEER_ARGS自定义 Puppeteer 启动选项（如浏览器类型、窗口大小等）。
适用场景
- 自动化测试：用于网页功能的自动化测试和验证。
- 数据抓取：从网页中提取数据或监控网页内容变化。
- 网页截图：生成网页或特定元素的截图，用于报告或存档。
- 交互式演示：模拟用户操作，用于演示或教学。
工具列表
- puppeteer_navigate：导航到指定 URL。
-
输入：
url（字符串）。 -
puppeteer_screenshot：捕获页面或元素的截图。
-
输入：
name（必填，截图名称）、selector（可选，CSS 选择器）、width（可选，默认 800）、height（可选，默认 600）。 -
puppeteer_click：点击页面元素。
-
输入：
selector（CSS 选择器）。 -
puppeteer_hover：悬停页面元素。
-
输入：
selector（CSS 选择器）。 -
puppeteer_fill：填写输入字段。
-
输入：
selector（CSS 选择器）、value（要填写的值）。 -
puppeteer_select：选择下拉菜单选项。
-
输入：
selector（CSS 选择器）、value（要选择的值）。 -
puppeteer_evaluate：在浏览器控制台中执行 JavaScript。
- 输入：
script（JavaScript 代码）。
常见问题解答
- 如何自定义浏览器类型？
-
通过
PUPPETEER_ARGS环境变量设置{"browser": "firefox"}即可使用 Firefox。 -
如何调整浏览器窗口大小？
- 通过
PUPPETEER_ARGS设置{"defaultViewport": {"width": 1280, "height": 800}}。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
-
通过 npx 安装：
json { "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"] } } } -
指定分支或标签：
json { "mcpServers": { "puppeteer": { "command": "npx", "args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"] } } }
调试方式
- 启动服务器后，使用提供的工具（如
puppeteer_navigate或puppeteer_screenshot）进行测试。 - 检查控制台日志（
console://logs）以查看浏览器输出。 - 验证截图是否生成（
screenshot://<name>）。