Puppeteer MCP Server (Python Implementation)

Name: Puppeteer MCP Server (Python Implementation)
Author: twolven

@twolven

关于 Puppeteer MCP Server (Python Implementation)

MCP server providing browser automation via Playwright (Python), enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser.

基本信息

分类

浏览器自动化

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

twolven

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-puppeteer-py": {
      "command": "python",
      "args": [
        "puppeteer_server.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Puppeteer MCP Server (Python Implementation)?

A Model Context Protocol server that provides browser automation capabilities using Playwright (Python's equivalent to Puppeteer). It enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.

How to use Puppeteer MCP Server (Python Implementation)?

Install the required packages with pip install -r requirements.txt, then install Playwright browsers using playwright install. Start the server by running python puppeteer_server.py, or configure it in Claude Desktop by adding a JSON entry with command "python" and args pointing to the server script.

Key features of Puppeteer MCP Server (Python Implementation)

Full browser automation capabilities
Page navigation to any URL
Screenshot capture of entire page or specific elements
Form interaction (clicking and filling fields)
JavaScript execution in the browser console
Configurable timeouts and detailed error handling
Comprehensive logging (INFO, ERROR, DEBUG levels)

Use cases of Puppeteer MCP Server (Python Implementation)

Automate web browsing tasks for LLM agents to gather information
Capture screenshots of web pages or specific elements for analysis
Programmatically fill forms and click buttons on websites
Execute custom JavaScript to extract data from dynamic pages
Monitor console logs during automated browser sessions

FAQ from Puppeteer MCP Server (Python Implementation)

What are the prerequisites for Puppeteer MCP Server (Python Implementation)?

Python 3.8+ and pip are required. Additionally, Playwright browsers must be installed using playwright install.

Does the browser run in headless mode?

No, the browser launches in non-headless mode for better debugging.

What is the default viewport size?

The default viewport size is 1280x720.

How are screenshots stored?

Screenshots are stored in memory with base64 encoding.

How does error handling work?

The server provides detailed error messages for navigation failures, element not found, timeout errors, JavaScript execution errors, and screenshot failures.