MCP-сервер с использованием браузера

MCP-сервер для использования в браузере .

Обзор

Этот репозиторий содержит сервер для библиотеки браузера , которая обеспечивает мощную систему автоматизации браузера, позволяющую агентам ИИ взаимодействовать с веб-браузерами посредством естественного языка. Сервер построен на протоколе контекста модели (MCP) Anthropic и обеспечивает бесшовную интеграцию с библиотекой браузера .

Related MCP server: browser-use MCP server

Функции

1. Управление браузером

• Автоматизированное взаимодействие с браузером посредством естественного языка

• Возможности навигации, заполнения форм, нажатия и прокрутки

• Управление вкладками и функциональность скриншотов

• Управление файлами cookie и состоянием

2. Система Агентов

• Реализация пользовательского агента в custom_agent.py

• Обнаружение элементов на основе зрения

• Структурированные ответы JSON для действий

• Управление историей сообщений и ее обобщение

3. Конфигурация

• Конфигурация API-ключей и настроек на основе среды

• Настройки браузера Chrome (порт отладки, сохранение)

• Выбор поставщика модели и параметры

Зависимости

Этот проект использует следующие пакеты Python:

Компоненты

Ресурсы

На сервере реализована система автоматизации браузера с:

• Интеграция с библиотекой браузера для расширенного управления браузером

• Возможности автоматизации пользовательского браузера

• Система взаимодействия на основе агентов с возможностями визуализации

• Постоянное управление состоянием

• Настраиваемые параметры модели

Требования

• Операционные системы (Linux, macOS, Windows; мы не тестировали Docker или Microsoft WSL)

• Python 3.11 или выше

• uv (быстрый установщик пакетов Python)

• Браузер Chrome/Chromium

• Клод Десктоп

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

Клод Десктоп

В MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json В Windows: %APPDATA%/Claude/claude_desktop_config.json

Установка через Smithery

Для автоматической установки Browser Use for Claude Desktop через Smithery :

npx -y @smithery/cli install @JovaniPink/mcp-browser-use --client claude

"mcpServers": {
  "mcp_server_browser_use": {
    "command": "uvx",
    "args": [
      "mcp-server-browser-use",
    ],
    "env": {
      "OPENAI_ENDPOINT": "https://api.openai.com/v1",
      "OPENAI_API_KEY": "",
      "ANTHROPIC_API_KEY": "",
      "GOOGLE_API_KEY": "",
      "AZURE_OPENAI_ENDPOINT": "",
      "AZURE_OPENAI_API_KEY": "",
      // "DEEPSEEK_ENDPOINT": "https://api.deepseek.com",
      // "DEEPSEEK_API_KEY": "",
      // Set to false to disable anonymized telemetry
      "ANONYMIZED_TELEMETRY": "false",
      // Chrome settings
      "CHROME_PATH": "",
      "CHROME_USER_DATA": "",
      "CHROME_DEBUGGING_PORT": "9222",
      "CHROME_DEBUGGING_HOST": "localhost",
      // Set to true to keep browser open between AI tasks
      "CHROME_PERSISTENT_SESSION": "false",
      // Model settings
      "MCP_MODEL_PROVIDER": "anthropic",
      "MCP_MODEL_NAME": "claude-3-5-sonnet-20241022",
      "MCP_TEMPERATURE": "0.3",
      "MCP_MAX_STEPS": "30",
      "MCP_USE_VISION": "true",
      "MCP_MAX_ACTIONS_PER_STEP": "5",
      "MCP_TOOL_CALL_IN_CONTENT": "true"
    }
  }
}

Переменные среды

Ключевые переменные среды:

# API Keys
ANTHROPIC_API_KEY=anthropic_key

# Chrome Configuration
# Optional: Path to Chrome executable
CHROME_PATH=/path/to/chrome
# Optional: Chrome user data directory
CHROME_USER_DATA=/path/to/user/data
# Default: 9222
CHROME_DEBUGGING_PORT=9222
# Default: localhost
CHROME_DEBUGGING_HOST=localhost
# Keep browser open between tasks
CHROME_PERSISTENT_SESSION=false

# Model Settings
# Options: anthropic, openai, azure, deepseek
MCP_MODEL_PROVIDER=anthropic
# Model name
MCP_MODEL_NAME=claude-3-5-sonnet-20241022
MCP_TEMPERATURE=0.3
MCP_MAX_STEPS=30
MCP_USE_VISION=true
MCP_MAX_ACTIONS_PER_STEP=5

Разработка

Настраивать

1. Клонируйте репозиторий:

git clone https://github.com/JovaniPink/mcp-browser-use.git
cd mcp-browser-use

2. Создать и активировать виртуальную среду:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Установить зависимости:

uv sync

4. Запустить сервер

uv run mcp-browser-use

Отладка

Для отладки используйте MCP Inspector :

npx @modelcontextprotocol/inspector uv --directory /path/to/project run mcp-server-browser-use

Инспектор отобразит URL-адрес интерфейса отладки.

Действия браузера

Сервер поддерживает различные действия браузера посредством естественного языка:

• Навигация: переход по URL-адресам, назад/вперед, обновление

• Взаимодействие: щелчок, ввод текста, прокрутка, наведение курсора.

• Формы: заполните формы, отправьте, выберите параметры

• Состояние: Получить содержимое страницы, сделать скриншоты

• Вкладки: создание, закрытие, переключение между вкладками

• Видение: поиск элементов по внешнему виду

• Файлы cookie и хранилище: управление состоянием браузера

Безопасность

Хочу отметить, что некоторые настройки Chrome настроены так, чтобы сервер мог управлять браузером. Это риск для безопасности и должно использоваться с осторожностью. Сервер не предназначен для использования в производственной среде.

Подробности безопасности: SECURITY.MD

Внося вклад

Мы приветствуем вклады в этот проект. Пожалуйста, выполните следующие шаги:

1. Сделайте форк этого репозитория.

2. Создайте ветку функций: git checkout -b my-new-feature .

3. Зафиксируйте изменения: git commit -m 'Add some feature' .

4. Отправка в ветку: git push origin my-new-feature .

5. Отправьте запрос на извлечение.

Для крупных изменений сначала откройте вопрос, чтобы обсудить, что вы хотели бы изменить. Пожалуйста, обновите тесты соответствующим образом, чтобы отразить любые внесенные изменения.