MCP-DevTools

MCP-DevTools

site icon
2025.03.05 0
JavaScript浏览器自动化开发者工具Docker 支持跨平台兼容性浏览器自动化开发效率
MCP-pptr 是一个基于 Model Context Protocol (MCP) 的服务实现,专注于通过 Puppeteer 提供增强的浏览器自动化和开发者工具(DevTools)能力。它支持全功能的浏览器自动化,集成了 DevTools 协议,并提供了 Docker 支持以确保环境一致性。此外,它还注重安全性,支持非 root 用户执行,并具有跨平台兼容性。
View on GitHub

Overview

基本能力

产品定位

MCP-pptr 是一个专注于浏览器自动化和开发者工具集成的服务,旨在通过 Puppeteer 提供高效的浏览器操作和调试能力。

核心功能

  • 全浏览器自动化支持:通过 Puppeteer 实现完整的浏览器自动化功能。
  • 增强的 DevTools 协议集成:提供更强大的开发者工具支持。
  • Docker 支持:确保在不同环境中运行的一致性。
  • 非 root 用户执行:提升安全性,避免权限问题。
  • 跨平台兼容性:支持多种操作系统和平台。

适用场景

  • 自动化测试:用于自动化测试网页应用。
  • 网页抓取:高效抓取网页数据。
  • 开发者工具调试:集成 DevTools 进行网页调试。
  • CI/CD 流程:在持续集成和部署流程中自动化浏览器操作。

工具列表

  • Puppeteer:提供浏览器自动化能力。
  • Docker:用于环境容器化和一致性管理。
  • Cursor IDE:用于配置和运行 MCP-pptr 服务。

常见问题解答

  • 如何配置端口? 默认运行在端口 3000,可通过环境变量调整。
  • 如何设置 Chromium 路径? 使用 PUPPETEER_EXECUTABLE_PATH 环境变量。
  • 如何启用 headless 模式? 设置 DISPLAY 环境变量。

使用教程

使用依赖

  • Docker:确保已安装 Docker。
  • Cursor IDE:用于配置服务。

安装教程

  1. 构建 Docker 镜像:
docker build -t mcp/puppeteer .
  1. 在 Cursor IDE 中配置:
  2. 打开 Cursor 设置。
  3. 导航到 MCP 配置。
  4. 添加以下命令:
docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

调试方式

  • 检查 Docker 容器日志:
docker logs <container_id>
  • 验证端口是否监听:
netstat -tuln | grep 3000
  • 检查环境变量配置是否正确。

许可证

该项目遵循 MIT 开源许可条款。