Примечание к проекту : Эта реализация сервера MCP основана на основе браузера-использования/веб-пользователя . Основная логика автоматизации браузера и шаблоны конфигурации адаптированы из оригинального проекта.
Сервер автоматизации браузера на базе ИИ, реализующий протокол Model Context Protocol (MCP) для управления браузером на естественном языке и веб-исследований. Также предоставляет доступ CLI к своим основным функциям.
run_browser_agent ).run_deep_research ).run_browser_agent , run_deep_research ) непосредственно из командной строки для тестирования и создания сценариев.curl -LsSf https://astral.sh/uv/install.sh | shuvx --from mcp-server-browser-use@latest python -m playwright installДля клиентов MCP, таких как Claude Desktop, добавьте простую конфигурацию сервера:
Ключевая информация: Лучшие конфигурации получаются, если начинать с простого (Пример 1). Файл .env.example содержит все возможные циферблаты.
Этот сервер предоставляет следующие инструменты через протокол контекста модели:
run_browser_agentMCP_AGENT_TOOL_* , MCP_LLM_* и MCP_BROWSER_* .task (строка, обязательно): Основная задача или цель.MCP_AGENT_TOOL_HISTORY_PATH .run_deep_researchMCP_RESEARCH_TOOL_* , MCP_LLM_* и MCP_BROWSER_* . Если задан MCP_RESEARCH_TOOL_SAVE_DIR , выходные данные сохраняются в подкаталоге внутри него; в противном случае работает в режиме только памяти.research_task (строка, обязательно): Тема или вопрос исследования.max_parallel_browsers (целое число, необязательное): переопределяет MCP_RESEARCH_TOOL_MAX_PARALLEL_BROWSERS из среды.Этот пакет также предоставляет интерфейс командной строки mcp-browser-cli для прямого тестирования и написания сценариев.
Глобальные параметры:
--env-file PATH, -e PATH : Путь к файлу .env для загрузки конфигураций.--log-level LEVEL, -l LEVEL : Переопределить уровень ведения журнала (например, DEBUG , INFO ).Команды:
mcp-browser-cli run-browser-agent [OPTIONS] TASKTASK (строка, обязательно): Основная задача для агента.mcp-browser-cli run-deep-research [OPTIONS] RESEARCH_TASKRESEARCH_TASK (строка, обязательно): Тема или вопрос для исследования.--max-parallel-browsers INTEGER, -p INTEGER : Переопределить MCP_RESEARCH_TOOL_MAX_PARALLEL_BROWSERS .Все остальные конфигурации (ключи LLM, пути, настройки браузера) берутся из переменных среды (или указанного файла .env ), как подробно описано в разделе «Конфигурация».
Настройте сервер и CLI с помощью переменных окружения. Вы можете задать их в своей системе или поместить в файл .env в корне проекта (используйте --env-file для CLI). Переменные структурированы с помощью префиксов.
| Группа переменных (префикс) | Пример переменной | Описание | Значение по умолчанию |
|---|---|---|---|
| Основная степень магистра права (MCP_LLM_) | Настройки для основного LLM, используемого агентами. | ||
MCP_LLM_PROVIDER | Поставщик LLM. Варианты: openai , azure_openai , anthropic , google , mistral , ollama и т. д. | openai | |
MCP_LLM_MODEL_NAME | Конкретное название модели для поставщика. | gpt-4.1 | |
MCP_LLM_TEMPERATURE | Температура LLM (0,0-2,0). | 0.0 | |
MCP_LLM_BASE_URL | Необязательно: общее переопределение базового URL-адреса поставщика LLM. | Специфичный для поставщика | |
MCP_LLM_API_KEY | Необязательно: универсальный ключ LLM API (имеет приоритет). | - | |
MCP_LLM_OPENAI_API_KEY | Ключ API для OpenAI (если поставщик — openai ). | - | |
MCP_LLM_ANTHROPIC_API_KEY | API-ключ для Anthropic. | - | |
MCP_LLM_GOOGLE_API_KEY | API-ключ для Google AI (Gemini). | - | |
MCP_LLM_AZURE_OPENAI_API_KEY | Ключ API для Azure OpenAI. | - | |
MCP_LLM_AZURE_OPENAI_ENDPOINT | Требуется при использовании Azure. Ваша конечная точка ресурса Azure. | - | |
MCP_LLM_OLLAMA_ENDPOINT | URL-адрес конечной точки API Ollama. | http://localhost:11434 | |
MCP_LLM_OLLAMA_NUM_CTX | Размер контекстного окна для моделей Ollama. | 32000 | |
| Планировщик LLM (MCP_LLM_PLANNER_) | Необязательно: Настройки для отдельного LLM для планирования агента. По умолчанию используется Main LLM, если не задано. | ||
MCP_LLM_PLANNER_PROVIDER | Поставщик услуг LLM Planner. | Основной поставщик LLM | |
MCP_LLM_PLANNER_MODEL_NAME | Название модели Planner LLM. | Основная модель LLM | |
| Браузер (MCP_BROWSER_) | Общие настройки браузера. | ||
MCP_BROWSER_HEADLESS | Запустить браузер без пользовательского интерфейса (общие настройки). | false | |
MCP_BROWSER_DISABLE_SECURITY | Отключите функции безопасности браузера (общая настройка, используйте осторожно). | false | |
MCP_BROWSER_BINARY_PATH | Путь к исполняемому файлу Chrome/Chromium. | - | |
MCP_BROWSER_USER_DATA_DIR | Путь к каталогу пользовательских данных Chrome. | - | |
MCP_BROWSER_WINDOW_WIDTH | Ширина окна браузера (в пикселях). | 1280 | |
MCP_BROWSER_WINDOW_HEIGHT | Высота окна браузера (в пикселях). | 1080 | |
MCP_BROWSER_USE_OWN_BROWSER | Подключитесь к браузеру пользователя через URL-адрес CDP. | false | |
MCP_BROWSER_CDP_URL | URL-адрес CDP (например, http://localhost:9222 ). Требуется, если MCP_BROWSER_USE_OWN_BROWSER=true . | - | |
MCP_BROWSER_KEEP_OPEN | Оставлять управляемый сервером браузер открытым между вызовами MCP (если MCP_BROWSER_USE_OWN_BROWSER=false ). | false | |
MCP_BROWSER_TRACE_PATH | Необязательно: Каталог для сохранения файлов трассировки Playwright. Если не задано, трассировка в файл отключена. | (пусто, трассировка отключена) | |
| Инструмент агента (MCP_AGENT_TOOL_) | Настройки для инструмента run_browser_agent . | ||
MCP_AGENT_TOOL_MAX_STEPS | Максимальное количество шагов за один запуск агента. | 100 | |
MCP_AGENT_TOOL_MAX_ACTIONS_PER_STEP | Максимальное количество действий на шаг агента. | 5 | |
MCP_AGENT_TOOL_TOOL_CALLING_METHOD | Метод вызова инструмента ('auto', 'json_schema', 'function_calling'). | auto | |
MCP_AGENT_TOOL_MAX_INPUT_TOKENS | Максимальное количество входных токенов для контекста LLM. | 128000 | |
MCP_AGENT_TOOL_USE_VISION | Включить возможности зрения (анализ снимков экрана). | true | |
MCP_AGENT_TOOL_HEADLESS | Переопределить MCP_BROWSER_HEADLESS для этого инструмента (true/false/пусто). | (использует общее) | |
MCP_AGENT_TOOL_DISABLE_SECURITY | Переопределить MCP_BROWSER_DISABLE_SECURITY для этого инструмента (true/false/пусто). | (использует общее) | |
MCP_AGENT_TOOL_ENABLE_RECORDING | Включить запись видео в режиме Playwright. | false | |
MCP_AGENT_TOOL_SAVE_RECORDING_PATH | Необязательно: Путь для сохранения записей. Если не задано, запись в файл отключена, даже если ENABLE_RECORDING=true . | (пусто, запись отключена) | |
MCP_AGENT_TOOL_HISTORY_PATH | Необязательно: Каталог для сохранения файлов истории агента JSON. Если не задано, сохранение истории отключено. | (пусто, сохранение истории отключено) | |
| Инструмент исследования (MCP_RESEARCH_TOOL_) | Настройки инструмента run_deep_research . | ||
MCP_RESEARCH_TOOL_MAX_PARALLEL_BROWSERS | Максимальное количество параллельных экземпляров браузера для глубоких исследований. | 3 | |
MCP_RESEARCH_TOOL_SAVE_DIR | Необязательно: Базовый каталог для сохранения исследовательских артефактов. Будет добавлен идентификатор задачи. Если не задано, работает в режиме только памяти. | None | |
| Пути (MCP_PATHS_) | Общие настройки пути. | ||
MCP_PATHS_DOWNLOADS | Необязательно: Каталог для загруженных файлов. Если не задано, постоянные загрузки по указанному пути отключены. | (пусто, загрузки отключены) | |
| Сервер (MCP_SERVER_) | Настройки, специфичные для сервера. | ||
MCP_SERVER_LOG_FILE | Путь к файлу журнала сервера. Пустой для stdout. | (пусто, выводит на стандартный вывод) | |
MCP_SERVER_LOGGING_LEVEL | Уровень ведения журнала ( DEBUG , INFO , WARNING , ERROR , CRITICAL ). | ERROR | |
MCP_SERVER_ANONYMIZED_TELEMETRY | Включить/отключить анонимную телеметрию ( true / false ). | true | |
MCP_SERVER_MCP_CONFIG | Необязательно: строка JSON для конфигурации клиента MCP, используемая внутренним контроллером. | null |
Поддерживаемые поставщики LLM ( MCP_LLM_PROVIDER ): openai , azure_openai , anthropic , google , mistral , ollama , deepseek , openrouter , alibaba , moonshot , unbound
(Полный список всех поддерживаемых переменных среды и их конкретных ключей/конечных точек поставщика см. в .env.example .)
Вместо того чтобы сервер запускал и управлял собственным экземпляром браузера, вы можете подключить его к браузеру Chrome/Chromium, который вы запускаете и управляете самостоятельно.
Шаги:
google-chrome --remote-debugging-port=9222 )uv run mcp-server-browser-use ) или CLI ( mcp-browser-cli ... ) как обычно.Важные соображения:
--remote-debugging-port должен оставаться открытым.MCP_BROWSER_HEADLESS и MCP_BROWSER_KEEP_OPEN игнорируются, если MCP_BROWSER_USE_OWN_BROWSER=true .MCP_RESEARCH_TOOL_SAVE_DIR ) правильно заданы в вашей среде или файле .env .MCP_BROWSER_USE_OWN_BROWSER=false ), убедитесь, что не запущены конфликтующие экземпляры Chrome с тем же каталогом пользовательских данных, если указан MCP_BROWSER_USER_DATA_DIR .MCP_BROWSER_USE_OWN_BROWSER=true :--remote-debugging-port .MCP_BROWSER_CDP_URL совпадает.MCP_LLM_<PROVIDER>_API_KEY или MCP_LLM_API_KEY ) и конечные точки (например, MCP_LLM_AZURE_OPENAI_ENDPOINT для Azure).MCP_AGENT_TOOL_USE_VISION=true и ваша степень магистра права поддерживает зрение.uv sync и uv run playwright install .MCP_AGENT_TOOL_HISTORY_PATH , MCP_BROWSER_TRACE_PATH , MCP_PATHS_DOWNLOADS ) и у приложения есть разрешения на запись в эти расположения.MCP_RESEARCH_TOOL_SAVE_DIR установлен в допустимом каталоге с возможностью записи.MCP_SERVER_LOG_FILE , если установлен) или вывод консоли. Увеличьте MCP_SERVER_LOGGING_LEVEL до DEBUG для получения более подробной информации. Для CLI используйте --log-level DEBUG .MIT — подробности см. в разделе ЛИЦЕНЗИЯ .
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Облегчает автоматизацию браузера с помощью настраиваемых возможностей и агентских взаимодействий, интегрированных через библиотеку использования браузера.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Saik0s/mcp-browser-use'
If you have feedback or need assistance with the MCP directory API, please join our Discord server