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 executemodel: 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
01f9be29c84f4a0e9408dd8544653a48574607e76ef7ad47b18cc325dbeb457c
|
|
| MD5 |
81a59587244bd9e0a3d19c53234819d0
|
|
| BLAKE2b-256 |
2b6b091d9bfb68bfd7ecdae3f992ba99bb330e9400eef62ab69f0951a75d496e
|
File details
Details for the file browser_use_mcp_console-0.1.0-py3-none-any.whl.
File metadata
- Download URL: browser_use_mcp_console-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
50df1cc080dab258634963dd3c6ed971c67e836ef9ae2911c966de4c476e218a
|
|
| MD5 |
29999665a7e0408bd873c9ed303d0a56
|
|
| BLAKE2b-256 |
96686d68f6bf0c091e01c2685324c4609ff7ed5cdc2b9391a49b6c488cf2cb80
|