# Browser-Use MCP Server
A Model Context Protocol (MCP) server that provides browser automation capabilities using [browser-use](https://github.com/browser-use/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):
```bash
playwright install chromium --with-deps --no-shell
```
### Using uvx (Recommended)
```bash
# 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
```bash
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](https://platform.openai.com/api-keys) - 获取 OPENAI_API_KEY
- [Anthropic](https://console.anthropic.com/account/keys) - 获取 ANTHROPIC_API_KEY
- [OpenRouter](https://openrouter.ai) - 获取 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:
```bash
# 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
Raw data
{
"_id": null,
"home_page": null,
"name": "browser-use-mcp-console",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, browser-automation, browser-use, console-debugging, mcp",
"author": "archie",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/bc/13/9d3b49b5b8ba721174acb198079b41fb3a83a13ea19625eebb63a49f2e69/browser_use_mcp_console-0.1.2.tar.gz",
"platform": null,
"description": "# Browser-Use MCP Server\n\nA Model Context Protocol (MCP) server that provides browser automation capabilities using [browser-use](https://github.com/browser-use/browser-use) with console debugging tools.\n\n## Features\n\n- \ud83c\udf10 Browser automation through MCP\n- \ud83d\udee0\ufe0f Console debugging capabilities for web applications\n- \u26a1 Parallel task execution support\n- \ud83d\udd12 Isolated browser sessions\n- \ud83d\udcca Real-time console log viewing\n\n## Installation\n\n### Prerequisites\n\nFirst, install Chromium browser (required by browser-use):\n\n```bash\nplaywright install chromium --with-deps --no-shell\n```\n\n### Using uvx (Recommended)\n\n```bash\n# Install uv if you haven't already\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Configure with Claude (\u9009\u62e9\u4e00\u4e2a API key)\nclaude mcp add browser-use \\\n --env OPENAI_API_KEY=your-api-key-here \\\n -- uvx browser-use-mcp-console\n\n# \u6216\u4f7f\u7528 OpenRouter\nclaude mcp add browser-use \\\n --env OPENROUTER_API_KEY=your-api-key-here \\\n -- uvx browser-use-mcp-console\n\n# \u6216\u4f7f\u7528 Anthropic\nclaude mcp add browser-use \\\n --env ANTHROPIC_API_KEY=your-api-key-here \\\n -- uvx browser-use-mcp-console\n```\n\n### Using pip\n\n```bash\npip install browser-use-mcp-console\n\n# Configure with Claude (\u9009\u62e9\u4e00\u4e2a API key)\nclaude mcp add browser-use \\\n --env OPENAI_API_KEY=your-api-key-here \\\n -- browser-use-mcp-console\n```\n\n### \u83b7\u53d6 API Key\n\n\u9009\u62e9\u5176\u4e2d\u4e00\u4e2a\u63d0\u4f9b\u5546\uff1a\n- [OpenAI](https://platform.openai.com/api-keys) - \u83b7\u53d6 OPENAI_API_KEY\n- [Anthropic](https://console.anthropic.com/account/keys) - \u83b7\u53d6 ANTHROPIC_API_KEY \n- [OpenRouter](https://openrouter.ai) - \u83b7\u53d6 OPENROUTER_API_KEY\uff08\u652f\u6301\u591a\u79cd\u6a21\u578b\uff09\n\n## Usage\n\nOnce configured, the MCP server provides the `run_browser_tasks` tool that can:\n\n- Execute single or multiple browser automation tasks\n- Run tasks in parallel for better performance\n- Enable console debugging for web application development\n\n### Example\n\n```\nRun browser automation task:\n- Task: \"Go to example.com and take a screenshot\"\n- Model: google/gemini-2.5-pro\n- Headless: false\n- Enable console: true\n```\n\n## Configuration\n\nThe server supports the following parameters:\n\n- `tasks`: List of tasks to execute\n- `model`: LLM model to use (default varies by provider:\n - OpenAI: \"gpt-4o-mini\"\n - Anthropic: \"claude-3-5-sonnet-20241022\"\n - OpenRouter: \"google/gemini-2.5-pro\")\n- `headless`: Whether to run browsers in headless mode (default: false)\n- `max_steps`: Maximum steps per task (default: 100)\n- `enable_console`: Enable console viewing capabilities (default: false)\n\n## Requirements\n\n- Python 3.11+\n- browser-use >= 0.5.6\n\n## Development\n\nTo contribute or modify:\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/browser-use-mcp-console\ncd browser-use-mcp-console\n\n# Install in development mode\npip install -e .\n```\n\n## License\n\nMIT License",
"bugtrack_url": null,
"license": null,
"summary": "MCP server for browser-use with console debugging capabilities",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://github.com/archie/browser-use-mcp-console#readme",
"Homepage": "https://github.com/archie/browser-use-mcp-console",
"Issues": "https://github.com/archie/browser-use-mcp-console/issues"
},
"split_keywords": [
"ai",
" browser-automation",
" browser-use",
" console-debugging",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ff20e91a0b84fa960e7d57f2793c16bc4a688067f1854da6993364987e7a1240",
"md5": "805c9442b21e9e933c70ba4d3a711204",
"sha256": "8db68a8faaea05435d8db754500d530b72b7bc6086105f7929f61d1d04b3d3a3"
},
"downloads": -1,
"filename": "browser_use_mcp_console-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "805c9442b21e9e933c70ba4d3a711204",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 10452,
"upload_time": "2025-08-15T10:14:34",
"upload_time_iso_8601": "2025-08-15T10:14:34.886495Z",
"url": "https://files.pythonhosted.org/packages/ff/20/e91a0b84fa960e7d57f2793c16bc4a688067f1854da6993364987e7a1240/browser_use_mcp_console-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bc139d3b49b5b8ba721174acb198079b41fb3a83a13ea19625eebb63a49f2e69",
"md5": "e75133c9f3f28141ecc0b6bf21e96c64",
"sha256": "286a0a189cd3f1b4795ffb622163ebd84160f20a5473e19059b516637db8f56a"
},
"downloads": -1,
"filename": "browser_use_mcp_console-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "e75133c9f3f28141ecc0b6bf21e96c64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 13608,
"upload_time": "2025-08-15T10:14:36",
"upload_time_iso_8601": "2025-08-15T10:14:36.144003Z",
"url": "https://files.pythonhosted.org/packages/bc/13/9d3b49b5b8ba721174acb198079b41fb3a83a13ea19625eebb63a49f2e69/browser_use_mcp_console-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-15 10:14:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "archie",
"github_project": "browser-use-mcp-console#readme",
"github_not_found": true,
"lcname": "browser-use-mcp-console"
}
JSON
