Puppeteer MCP Server (Python Implementation)
2024.12.21
4
Python浏览器自动化网页测试数据抓取浏览器自动化
Puppeteer MCP Server (Python Implementation) 是一个基于Playwright的浏览器自动化服务，为LLM（大型语言模型）提供与网页交互的能力。该服务支持页面导航、截图捕获、表单交互、JavaScript执行等功能，并具备详细的错误处理和日志记录。
View on GitHub
Overview
基本能力
产品定位
Puppeteer MCP Server (Python Implementation) 是一个浏览器自动化服务，旨在为LLM提供与网页交互的能力，支持多种浏览器操作。
核心功能
- 完整的浏览器自动化
- 页面导航
- 截图捕获（全页或特定元素）
- 表单交互（点击和填写）
- JavaScript执行
- 控制台日志监控
- 可配置的超时设置
- 详细的错误处理
- 全面的日志记录
适用场景
- 网页自动化测试
- 数据抓取
- 网页截图生成
- 表单自动填写
- JavaScript代码执行
工具列表
- puppeteer_navigate：导航到指定URL。
- puppeteer_screenshot：捕获页面或特定元素的截图。
- puppeteer_click：点击页面上的元素。
- puppeteer_fill：填写输入字段。
- puppeteer_evaluate：在浏览器控制台中执行JavaScript。
常见问题解答
- 导航失败：检查URL是否正确，网络是否通畅。
- 元素未找到：确认选择器是否正确，元素是否存在于页面上。
- 超时错误：增加超时时间或检查页面加载速度。
- JavaScript执行错误：检查脚本语法是否正确。
- 截图失败：确认截图路径是否有写入权限。
使用教程
使用依赖
- 安装Python 3.8+。
- 安装pip（Python包安装工具）。
安装教程
- 安装所需包：
pip install -r requirements.txt
- 安装Playwright浏览器：
playwright install
调试方式
- 启动服务器：
python puppeteer_server.py
- 配置Claude Desktop：
{
"mcpServers": {
"puppeteer": {
"command": "python",
"args": ["path/to/puppeteer.py"]
}
}
}