Skip to main content

MCP server for browser-use with console debugging capabilities

Project description

Browser-Use MCP Server

A Model Context Protocol (MCP) server that provides browser automation capabilities using browser-use with console debugging tools.

Features

  • 🌐 Browser automation through MCP
  • 🛠️ Console debugging capabilities for web applications
  • ⚡ Parallel task execution support
  • 🔒 Isolated browser sessions
  • 📊 Real-time console log viewing

Installation

Prerequisites

First, install Chromium browser (required by browser-use):

playwright install chromium --with-deps --no-shell

Using uvx (Recommended)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Configure with Claude (选择一个 API key)
claude mcp add browser-use \
  --env OPENAI_API_KEY=your-api-key-here \
  -- uvx browser-use-mcp-console

# 或使用 OpenRouter
claude mcp add browser-use \
  --env OPENROUTER_API_KEY=your-api-key-here \
  -- uvx browser-use-mcp-console

# 或使用 Anthropic
claude mcp add browser-use \
  --env ANTHROPIC_API_KEY=your-api-key-here \
  -- uvx browser-use-mcp-console

Using pip

pip install browser-use-mcp-console

# Configure with Claude (选择一个 API key)
claude mcp add browser-use \
  --env OPENAI_API_KEY=your-api-key-here \
  -- browser-use-mcp-console

获取 API Key

选择其中一个提供商:

  • OpenAI - 获取 OPENAI_API_KEY
  • Anthropic - 获取 ANTHROPIC_API_KEY
  • OpenRouter - 获取 OPENROUTER_API_KEY(支持多种模型)

Usage

Once configured, the MCP server provides the run_browser_tasks tool that can:

  • Execute single or multiple browser automation tasks
  • Run tasks in parallel for better performance
  • Enable console debugging for web application development

Example

Run browser automation task:
- Task: "Go to example.com and take a screenshot"
- Model: google/gemini-2.5-pro
- Headless: false
- Enable console: true

Configuration

The server supports the following parameters:

  • tasks: List of tasks to execute
  • model: LLM model to use (default varies by provider:
    • OpenAI: "gpt-4o-mini"
    • Anthropic: "claude-3-5-sonnet-20241022"
    • OpenRouter: "google/gemini-2.5-pro")
  • headless: Whether to run browsers in headless mode (default: false)
  • max_steps: Maximum steps per task (default: 100)
  • enable_console: Enable console viewing capabilities (default: false)

Requirements

  • Python 3.11+
  • browser-use >= 0.5.6

Development

To contribute or modify:

# Clone the repository
git clone https://github.com/yourusername/browser-use-mcp-console
cd browser-use-mcp-console

# Install in development mode
pip install -e .

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

browser_use_mcp_console-0.1.0.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

browser_use_mcp_console-0.1.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file browser_use_mcp_console-0.1.0.tar.gz.

File metadata

  • Download URL: browser_use_mcp_console-0.1.0.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.5

File hashes

Hashes for browser_use_mcp_console-0.1.0.tar.gz
Algorithm Hash digest
SHA256 01f9be29c84f4a0e9408dd8544653a48574607e76ef7ad47b18cc325dbeb457c
MD5 81a59587244bd9e0a3d19c53234819d0
BLAKE2b-256 2b6b091d9bfb68bfd7ecdae3f992ba99bb330e9400eef62ab69f0951a75d496e

See more details on using hashes here.

File details

Details for the file browser_use_mcp_console-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for browser_use_mcp_console-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 50df1cc080dab258634963dd3c6ed971c67e836ef9ae2911c966de4c476e218a
MD5 29999665a7e0408bd873c9ed303d0a56
BLAKE2b-256 96686d68f6bf0c091e01c2685324c4609ff7ed5cdc2b9391a49b6c488cf2cb80

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page