Сервер Model Context Protocol, который предоставляет возможности автоматизации браузера с использованием Playwright (эквивалент Puppeteer от Python). Этот сервер позволяет LLM взаимодействовать с веб-страницами, делать скриншоты и выполнять JavaScript в реальной среде браузера.

Обзор

Эта реализация Python обеспечивает стабильную альтернативу версии TypeScript, предлагая те же возможности с улучшенной обработкой ошибок и журналированием. Он использует Playwright, который является эквивалентом Python Puppeteer, обеспечивая надежные возможности автоматизации браузера.

Ключевые особенности

• Полная автоматизация браузера
• Навигация по страницам
• Скриншот (полная страница или элементы)
• Взаимодействие форм (кликинг и заполнение)
• JavaScript выполнение
• Мониторинг журнала консоли
• Настраиваемые тайм-ауты
• Подробная обработка ошибок
• Всеобъемлющий лесозаготовительный

Предпосылки

Python 3.8+

• pip (установщик пакетов Python)

##Установка 1.Установить необходимые пакеты:

2.Установите браузер Playwright:

Использование

Запуск сервера

Запустите сервер напрямую:

###Клод Конфигурация рабочего стола Добавьте это в конфигурационный файл Claude:

Доступные инструменты

кукловод навигация

Перейдите на любой URL в браузере.

Puppeteer MCP Server (Python Implementation)

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

Overview

This Python implementation provides a stable alternative to the TypeScript version, offering the same capabilities with improved error handling and logging. It uses Playwright, which is the Python equivalent to Puppeteer, providing robust browser automation capabilities.

Key Features

• Full browser automation
• Page navigation
• Screenshot capture (full page or elements)
• Form interaction (clicking and filling)
• JavaScript execution
• Console log monitoring
• Configurable timeouts
• Detailed error handling
• Comprehensive logging

Prerequisites

• Python 3.8+
• pip (Python package installer)

Installation

1. Install the required packages:

pip install -r requirements.txt

2. Install Playwright browsers:

playwright install

Usage

Starting the Server

Run the server directly:

python puppeteer_server.py

Claude Desktop Configuration

Add this to your Claude configuration file:

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

Available Tools

puppeteer_navigate

Navigate to any URL in the browser.

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

puppeteer_screenshot

Capture screenshots of the entire page or specific elements.

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

Click elements on the page.

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

puppeteer_fill

Fill out input fields.

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

puppeteer_evaluate

Execute JavaScript in the browser console.

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

Error Handling

The server provides detailed error messages for common scenarios:

• Navigation failures
• Element not found
• Timeout errors
• JavaScript execution errors
• Screenshot failures

Logging

Comprehensive logging is implemented with different levels:

• INFO: Standard operations
• ERROR: Operation failures