MCP-pptr

🚀 MCP-DevTools

MCP-DevTools 是一个基于 Puppeteer 实现的 Model Context Protocol (MCP) 服务器，旨在增强浏览器自动化和 DevTools 功能，为开发者提供更便捷、高效的开发体验。

🚀 快速开始

先决条件

• Docker
• Cursor IDE

设置步骤

1. 构建 Docker 镜像：

docker build -t mcp/puppeteer .

2. 在 Cursor 中进行配置：
   • 打开 Cursor 设置。
   • 导航到 MCP 配置。
   • 添加以下命令：

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

✨ 主要特性

• 借助 Puppeteer 实现全面的浏览器自动化支持。
• 增强的 DevTools 协议集成。
• 支持 Docker，确保环境一致性。
• 以非 root 用户身份运行，提高安全性。
• 具备跨平台兼容性。

📦 安装指南

构建 Docker 镜像

docker build -t mcp/puppeteer .

在 Cursor 中配置

1. 打开 Cursor 设置。
2. 导航到 MCP 配置。
3. 添加命令：

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

📚 详细文档

配置说明

服务器默认运行在 3000 端口，可通过以下环境变量进行配置： | 属性 | 详情 | |------|------| | PUPPETEER_EXECUTABLE_PATH | Chromium 可执行文件路径 | | DISPLAY | X11 显示用于无头模式 | | CHROME_BIN | Chrome 二进制文件路径 |

安全性说明

• 在 Docker 中以非 root 用户身份运行。
• 使用 Chromium 的沙盒。
• 实现了适当的权限管理。

📄 许可证

本项目采用 MIT License。

🤝 贡献指南

1. Fork 仓库。
2. 创建功能分支。
3. 提交更改。
4. 推送到分支。
5. 创建新的 Pull Request。