MCP Server Puppeteer Py

Puppeteer MCP服务器（Python实现）

一个模型上下文协议服务器，使用Playwright（Python相当于Puppeteer）提供浏览器自动化功能。此服务器使LLM能够在真实的浏览器环境中与网页交互、截图和执行JavaScript。

概述

这个Python实现为TypeScript版本提供了一个稳定的替代方案，通过改进错误处理和日志记录提供了相同的功能。它使用Playwright，这是Python的Puppeteer，提供强大的浏览器自动化功能。

主要特点

• 完全浏览器自动化
• 页面导航
• 截图（整页或元素）
• 表单交互（点击和填写）
• JavaScript执行
• 控制台日志监控
• 可配置超时
• 详细的错误处理
• 综合录井

先决条件

• Python 3.8+
• pip（Python包安装程序）

安装

1. 安装所需的软件包：

pip install -r requirements.txt

1. 安装Playwright浏览器：

playwright install

用法

启动服务器

直接运行服务器：

python puppeteer_server.py

Claude桌面配置

将以下内容添加到您的Claude配置文件中：

{
  "mcpServers": {
    "puppeteer": {
      "command": "python",
      "args": ["path/to/puppeteer.py"]
    }
  }
}

可用工具

puppeteer_navigation

导航到浏览器中的任何URL。

{
  "name": "puppeteer_navigate",
  "arguments": {
    "url": "https://example.com",
    "timeout": 60000  // optional, defaults to 60000ms
  }
}

木偶戏

捕获整个页面或特定元素的屏幕截图。

{
  "name": "puppeteer_screenshot",
  "arguments": {
    "name": "my_screenshot",
    "selector": "#specific-element",  // optional
    "width": 1280,  // optional, default: 1280
    "height": 720,  // optional, default: 720
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

木偶戏

单击页面上的元素。

{
  "name": "puppeteer_click",
  "arguments": {
    "selector": ".button-class",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

木偶戏

填写输入字段。

{
  "name": "puppeteer_fill",
  "arguments": {
    "selector": "#input-id",
    "value": "text to fill",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

木偶师_评价

在浏览器控制台中执行JavaScript。

{
  "name": "puppeteer_evaluate",
  "arguments": {
    "script": "document.title",
    "timeout": 30000  // optional, defaults to 30000ms
  }
}

错误处理

服务器为常见场景提供详细的错误消息：

• 导航失败
• 未找到元素
• 超时错误
• JavaScript执行错误
• 屏幕截图故障

日志记录

综合日志记录分为不同级别：

• 信息：标准操作
• 错误：操作失败
• 调试：详细的执行信息

备注

• 浏览器以非无头模式启动，以便更好地调试
• 默认视口大小为1280x720
• 所有超时都是可配置的
• 控制台日志被捕获并存储
• 屏幕截图以base64编码存储在内存中

贡献

欢迎投稿！在提交pull请求之前，请阅读存储库的贡献指南。

许可证

此项目在Apache 2.0许可证下获得许可-有关详细信息，请参阅License文件。