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.1.tar.gz (10.1 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.1-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: browser_use_mcp_console-0.1.1.tar.gz
  • Upload date:
  • Size: 10.1 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.1.tar.gz
Algorithm Hash digest
SHA256 6d51b0fb162984a8874876ec22139e34f14d8273f848344a13d07dcfa749bece
MD5 d4bd4e686d8ccd001c6c807393c14b29
BLAKE2b-256 4b3c5f7b99915c0afeefc0fa5995c50feaf85adaea2c6c56a3c12520ecb8ac97

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for browser_use_mcp_console-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a90022f695cee52a6395c2ec377e8fa7067b6e8007b0b919a24dda5a6ad157dd
MD5 0bc5d2bb8da4a1e2f95ee27765dba94d
BLAKE2b-256 5c95f87d0481b88e7c67fa990f617a9d01b537087b4f75aa729e72bc282cecaf

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