Mcp Сервер Плейрайт

Что такое MCP-Server-Playwright?

MCP-Server-Playwright — это инновационный сервер, разработанный для автоматизации браузеров с использованием Playwright, мощной библиотеки, которая позволяет разработчикам автоматизировать веб-приложения в различных браузерах. Этот проект особенно полезен для тестирования и веб-скрапинга, позволяя пользователям имитировать взаимодействия с пользователем и эффективно собирать данные.

Особенности MCP-Server-Playwright

• Поддержка нескольких браузеров: MCP-Server-Playwright поддерживает несколько браузеров, включая Chrome, Firefox и Safari, что обеспечивает бесшовное выполнение ваших автоматизационных скриптов в различных средах.
• Легкая установка: Сервер разработан для быстрой установки и настройки, что делает его доступным для разработчиков любого уровня подготовки.
• Надежный API: Он предоставляет обширный API, который позволяет детально управлять взаимодействиями с браузером, включая навигацию, выбор элементов и обработку событий.
• Безголовый режим: Пользователи могут запускать тесты в безголовом режиме, что идеально подходит для CI/CD пайплайнов и сред, где графический интерфейс недоступен.
• Обширная документация: Проект поставляется с подробной документацией, что облегчает разработчикам начало работы и эффективное использование всех функций.

Как использовать MCP-Server-Playwright

1. Установка: Начните с клонирования репозитория с GitHub:

   git clone https://github.com/Automata-Labs-team/MCP-Server-Playwright.git
   cd MCP-Server-Playwright
   

2. Зависимости: Установите необходимые зависимости с помощью npm или yarn:

   npm install
   

3. Запуск сервера: Запустите сервер с помощью следующей команды:

   npm start
   

4. Создание автоматизационных скриптов: Напишите свои автоматизационные скрипты, используя предоставленный API. Вот простой пример для перехода на веб-страницу:

   const { chromium } = require('playwright');
   
   (async () => {
       const browser = await chromium.launch();
       const page = await browser.newPage();
       await page.goto('https://example.com');
       await browser.close();
   })();
   

5. Тестирование и отладка: Используйте встроенные инструменты отладки для тестирования ваших скриптов и обеспечения их правильной работы.

Часто задаваемые вопросы

Что такое Playwright?

Playwright — это библиотека автоматизации с открытым исходным кодом, разработанная Microsoft, которая позволяет разработчикам автоматизировать веб-приложения в различных браузерах. Она поддерживает современные функции веб-приложений и предоставляет богатый API для взаимодействия с браузером.

Могу ли я использовать MCP-Server-Playwright для веб-скрапинга?

Да, MCP-Server-Playwright отлично подходит для задач веб-скрапинга. Его способность автоматизировать действия браузера упрощает извлечение данных с веб-страниц.

Является ли MCP-Server-Playwright бесплатным для использования?

Абсолютно! MCP-Server-Playwright является проектом с открытым исходным кодом и доступен для любого использования, модификации и распространения по лицензии MIT.

Как я могу внести свой вклад в проект?

Внесение вклада приветствуется! Вы можете внести свой вклад, отправив проблемы, запросы на функции или пулл-реквесты в репозиторий на GitHub. Пожалуйста, ознакомьтесь с руководством по внесению вклада в документации для получения более подробной информации.

Где я могу найти документацию?

Документация для MCP-Server-Playwright доступна в репозитории. Вы можете получить к ней доступ напрямую здесь.

<h1 align="center">MCP Server Playwright</h1> <p align="center"> <a href="https://www.automatalabs.io"><img alt="MCP Playwright" src="https://automatalabs.io/icon.svg" height="250"/></a> </p> <p align="center"> <b>A Model Context Protocol server that provides browser automation capabilities using Playwright</b></br> _{Enable LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment} </p> <p align="center"> <a href="https://www.npmjs.com/package/@automatalabs/mcp-server-playwright"><img alt="NPM Version" src="https://img.shields.io/npm/v/@automatalabs/mcp-server-playwright.svg" height="20"/></a> <a href="https://npmcharts.com/compare/@automatalabs/mcp-server-playwright?minimal=true"><img alt="Downloads per month" src="https://img.shields.io/npm/dm/@automatalabs/mcp-server-playwright.svg" height="20"/></a> <a href="https://github.com/Automata-Labs-team/MCP-Server-Playwright/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/Automata-Labs-team/MCP-Server-Playwright.svg" height="20"/></a> <a href="https://smithery.ai/server/@automatalabs/mcp-server-playwright"><img alt="Smithery Installs" src="https://smithery.ai/badge/@automatalabs/mcp-server-playwright" height="20"/></a> </p>

<a href="https://glama.ai/mcp/servers/9q4zck8po5"><img width="380" height="200" src="https://glama.ai/mcp/servers/9q4zck8po5/badge" alt="MCP-Server-Playwright MCP server" /></a>

Table of Contents

• Features
• Installation
• Configuration
• Components
  • Tools
  • Resources
• License

Features

• 🌐 Full browser automation capabilities
• 📸 Screenshot capture of entire pages or specific elements
• 🖱️ Comprehensive web interaction (navigation, clicking, form filling)
• 📊 Console log monitoring
• 🔧 JavaScript execution in browser context

Installation

Installing via Smithery

To install MCP Server Playwright for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude

You can install the package using either npx or mcp-get:

Using npx:

npx @automatalabs/mcp-server-playwright install

This command will:

1. Check your operating system compatibility (Windows/macOS)
2. Create or update the Claude configuration file
3. Configure the Playwright server integration

The configuration file will be automatically created/updated at:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Using mcp-get:

npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright

Configuration

The installation process will automatically add the following configuration to your Claude config file:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

Using with Cursor

You can also use MCP Server Playwright with Cursor, an AI-powered code editor. To enable browser automation in Cursor via MCP:

1. Install Playwright browsers (if not already):

   npx playwright install
   

2. Install MCP Server Playwright for Cursor using Smithery:

   npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client cursor
   

3. Configuration file setup:
   If you do not use Claude, the configuration file (claude_desktop_config.json) may not be created automatically.

   • On Windows, create a folder named Claude in %APPDATA% (usually C:\Users\<YourName>\AppData\Roaming\Claude).
   • Inside that folder, create a file named claude_desktop_config.json with the following content:

   {
     "serverPort": 3456
   }
   

4. Follow the remaining steps in the Installation section above to complete the setup.

Now, you can use all the browser automation tools provided by MCP Server Playwright directly from Cursor’s AI features, such as web navigation, screenshot capture, and JavaScript execution.

Note: Make sure you have Node.js installed and npx available in your system PATH.

Components

Tools

browser_navigate

Navigate to any URL in the browser

{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

Capture screenshots of the entire page or specific elements

{
  "name": "screenshot-name",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: false
}

browser_click

Click elements on the page using CSS selector

{
  "selector": "#button-id"
}

browser_click_text

Click elements on the page by their text content

{
  "text": "Click me"
}

browser_hover

Hover over elements on the page using CSS selector

{
  "selector": "#menu-item"
}

browser_hover_text

Hover over elements on the page by their text content

{
  "text": "Hover me"
}

browser_fill

Fill out input fields

{
  "selector": "#input-field",
  "value": "Hello World"
}

browser_select

Select an option in a SELECT element using CSS selector

{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

Select an option in a SELECT element by its text content

{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

Execute JavaScript in the browser console

{
  "script": "document.title"
}

Resources

1. Console Logs (console://logs)

   • Access browser console output in text format
   • Includes all console messages from the browser

2. Screenshots (screenshot://<n>)

   • Access PNG images of captured screenshots
   • Referenced by the name specified during capture

License

This project is licensed under the MIT License - see the LICENSE file for details.