chrome-mcp-server by YohAsacura - MCP Server

Chrome MCP Server

MCP сервер для автоматизации Chrome браузера через Model Context Protocol

🚀 Возможности

Полная автоматизация браузера - открытие страниц, клики, ввод текста
Веб-скрапинг - извлечение данных, выполнение JavaScript
Тестирование - автоматизация UI тестов
Скриншоты - создание снимков страниц
Гибкие селекторы - CSS, XPath, ID, Name, Class, Tag

📋 Требования

Python 3.10+
Google Chrome (последняя версия)
Windows / macOS / Linux

⚡ Быстрый старт

Установка

# Клонировать/скопировать проект
cd chrome-mcp-server

# Установить зависимости
pip install -r requirements.txt

Или использовать скрипт (Windows):

scripts\install.bat

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

python src/server.py

Или:

scripts\start.bat

Интеграция с Claude Desktop

Добавьте в конфигурацию (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "chrome-automation": {
      "command": "python",
      "args": ["ПОЛНЫЙ_ПУТЬ/chrome-mcp-server/src/server.py"]
    }
  }
}

Замените ПОЛНЫЙ_ПУТЬ на абсолютный путь к проекту.

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

Инструмент	Описание
`browser_start`	Запустить браузер (опция headless)
`browser_stop`	Остановить браузер
`navigate`	Открыть URL
`click_element`	Кликнуть по элементу
`type_text`	Ввести текст в поле
`find_element`	Найти элемент и получить информацию
`get_text`	Получить текст элемента
`screenshot`	Создать скриншот страницы
`execute_javascript`	Выполнить JS код
`get_page_info`	Получить информацию о странице
`browser_back`	Назад в истории
`browser_forward`	Вперед в истории
`browser_refresh`	Обновить страницу
`get_page_html` ⭐	Получить HTML код страницы
`get_all_text` ⭐	Получить весь текст страницы (быстрее скриншота!)
`get_elements_info` ⭐	Получить информацию о нескольких элементах
`get_page_structure` ⭐	Получить структуру: заголовки, ссылки, формы и т.д.

⭐ Новые инструменты для быстрого анализа - вместо скриншотов используйте текстовые данные!

💡 Примеры использования

Анализ страницы (БЕЗ скриншота!)

Открой google.com и получи структуру страницы

Или:

Открой новостной сайт и получи весь текст для анализа

Извлечение данных

Открой сайт с товарами, найди все элементы .product-card 
и покажи их названия и цены

Простой поиск

Запусти браузер, открой google.com и сделай скриншот

Автоматизация

Открой github.com, найди поле поиска, введи "selenium" и нажми Enter

Веб-скрапинг

Открой news.ycombinator.com и извлеки первые 10 заголовков с помощью JavaScript

Заполнение формы

Открой страницу регистрации, заполни поле email: test@example.com, 
заполни поле пароля и кликни на кнопку submit

📁 Структура проекта

chrome-mcp-server/
├── src/                    # Исходный код
│   ├── server.py          # MCP сервер
│   ├── browser_manager.py # Менеджер браузера
│   └── __init__.py
├── config/                 # Конфигурация
├── docs/                   # Документация
├── examples/               # Примеры кода
├── scripts/                # Утилиты установки/запуска
├── tests/                  # Тесты
├── requirements.txt        # Зависимости Python
├── pyproject.toml         # Настройки проекта
└── README.md              # Этот файл

📚 Документация

- детальная инструкция для начинающих
- продвинутые сценарии
- подробное описание всех инструментов

🔧 Конфигурация

Headless режим

{
  "tool": "browser_start",
  "arguments": { "headless": true }
}

Настройка timeout

В src/browser_manager.py:

self.timeout = 20  # по умолчанию 10 секунд

🧪 Тестирование

pytest tests/ -v

🐛 Устранение проблем

Браузер не запускается

Проверьте установку Chrome: chrome --version
Обновите Selenium: pip install --upgrade selenium

Элемент не найден

Увеличьте timeout в browser_manager.py
Проверьте правильность селектора
Убедитесь что страница полностью загрузилась

Ошибки импорта

Переустановите зависимости: pip install -r requirements.txt --force-reinstall

🤝 Вклад

Приветствуются улучшения! Создавайте issues и pull requests.

📄 Лицензия

MIT License - см.

📞 Поддержка

Issues: создайте issue в репозитории
Документация: см. папку docs/
Примеры: см. папку examples/

Версия: 0.2.0 | Python: 3.10+ | Статус: Production Ready ✅