Puppeteer MCP Server (Python Implementation)
2024.12.27
1
Python浏览器自动化浏览器自动化
Puppeteer MCP Server (Python Implementation) 是一个基于 Playwright 的浏览器自动化服务，为 LLMs 提供了与网页交互的能力，包括页面导航、截图捕获、表单交互、JavaScript 执行等功能。该服务是 TypeScript 版本的稳定替代方案，具有改进的错误处理和日志记录功能。
View on GitHub
Overview
基本能力
产品定位
该服务是一个浏览器自动化工具，旨在为语言模型提供与网页交互的能力。
核心功能
- 完整的浏览器自动化
- 页面导航
- 截图捕获（全页或特定元素）
- 表单交互（点击和填写）
- 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 install
安装教程
- 安装所需包：
pip install -r requirements.txt
- 安装 Playwright 浏览器：
playwright install
调试方式
启动服务器：
python puppeteer_server.py
Claude 桌面配置：
{
"mcpServers": {
"puppeteer": {
"command": "python",
"args": ["path/to/puppeteer.py"]
}
}
}