local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables execution of JavaScript code in the browser console to manipulate web pages and extract information.
Provides browser automation capabilities including page navigation, screenshot capture, form interaction, and JavaScript execution in a real browser environment.

Puppeteer MCP 服务器（Python 实现）

一个模型上下文协议 (MLM) 服务器，使用 Playwright（Python 版 Puppeteer）提供浏览器自动化功能。该服务器使 LLM 能够在真实的浏览器环境中与网页交互、截取屏幕截图并执行 JavaScript。

概述

此 Python 实现提供了 TypeScript 版本的稳定替代方案，在提供相同功能的同时，还改进了错误处理和日志记录功能。它使用了 Playwright（相当于 Puppeteer 的 Python 版本），提供强大的浏览器自动化功能。

主要特点

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

先决条件

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

安装

安装所需的软件包：

pip install -r requirements.txt

安装 Playwright 浏览器：

playwright install

用法

启动服务器

直接运行服务器：

python puppeteer_server.py

Claude桌面配置

将其添加到您的 Claude 配置文件中：

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

可用工具

puppeteer_navigate

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

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

puppeteer_screenshot

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

{
  "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
  }
}

puppeteer_click

单击页面上的元素。

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

puppeteer_fill

填写输入字段。

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

puppeteer_evaluate

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

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

错误处理

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

导航失败
未找到元素
超时错误
JavaScript 执行错误
截图失败

日志记录

全面的日志记录以不同的级别实现：

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

笔记

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

贡献

欢迎贡献！提交拉取请求之前，请阅读代码库的贡献指南。

执照

该项目根据 Apache 2.0 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

模型上下文协议服务器使用 Playwright 提供浏览器自动化功能，使 LLM 能够在真实的浏览器环境中与网页交互、截屏和执行 JavaScript。

Related Resources

Reddit Discussion about this server

Puppeteer MCP Server