browser-use-mcp-server
Browse the web, directly from Cursor etc.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kontext-security/browser-use-mcp-server with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kontext-security/browser-use-mcp-server'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/kontext-security--browser-use-mcp-server)HTML
<a href="/listings/kontext-security--browser-use-mcp-server"><img src="/api/listings/kontext-security--browser-use-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# Install dependencies uv sync uv pip install playwright uv run playwright install --with-deps --no-shell chromium
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 222 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # browser-use-mcp-server
- <div align="center">
- [](https://x.com/cobrowser)
- [](https://discord.gg/gw9UpFUhyY)
- [](https://badge.fury.io/py/browser-use-mcp-server)
- **An MCP server that enables AI agents to control web browsers using
- [browser-use](https://github.com/browser-use/browser-use).**
- > **🌐 Want to Vibe Browse the Web?** Open-source AI-powered web browser - [**Vibe Browser**](https://github.com/co-browser/vibe).
- >
- > **🔗 Managing multiple MCP servers?** Simplify your development workflow with [agent-browser](https://github.com/co-browser/agent-browser)
- </div>
- ## Prerequisites
- - [uv](https://github.com/astral-sh/uv) - Fast Python package manager
- - [Playwright](https://playwright.dev/) - Browser automation
- - [mcp-proxy](https://github.com/sparfenyuk/mcp-proxy) - Required for stdio mode
- ```bash
- # Install prerequisites
- curl -LsSf https://astral.sh/uv/install.sh | sh
- uv tool install mcp-proxy
- uv tool update-shell
- ```
- ## Environment
- Create a `.env` file:
- ```bash
- OPENAI_API_KEY=your-api-key
- CHROME_PATH=optional/path/to/chrome
- PATIENT=false # Set to true if API calls should wait for task completion
- ```
- ## Installation
- ```bash
- # Install dependencies
- uv sync
- uv pip install playwright
- uv run playwright install --with-deps --no-shell chromium
- ```
- ## Usage
- ### SSE Mode
- ```bash
- # Run directly from source
- uv run server --port 8000
- ```
- ### stdio Mode
- ```bash
- # 1. Build and install globally
- uv build
- uv tool uninstall browser-use-mcp-server 2>/dev/null || true
- uv tool install dist/browser_use_mcp_server-*.whl
- # 2. Run with stdio transport
- browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
- ```
- ## Client Configuration
- ### SSE Mode Client Configuration
- ```json
- {
- "mcpServers": {
- "browser-use-mcp-server": {
- "url": "http://localhost:8000/sse"
- }
- }
- }
- ```
- ### stdio Mode Client Configuration
- ```json
- {
- "mcpServers": {
- "browser-server": {
- "command": "browser-use-mcp-server",
- "args": [
- "run",
- "server",
- "--port",
- "8000",
- "--stdio",
- "--proxy-port",
- "9000"
- ],
- "env": {
- "OPENAI_API_KEY": "your-api-key"
- }
- }
- }
- }
- ```
- ### Config Locations
- | Client | Configuration Path |
- | ---------------- | ----------------------------------------------------------------- |
- | Cursor | `./.cursor/mcp.json` |
- | Windsurf | `~/.codeium/windsurf/mcp_config.json` |
- | Claude (Mac) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
- | Claude (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
- ## Features
- - [x] **Browser Automation**: Control browsers through AI agents
- - [x] **Dual Transport**: Support for both SSE and stdio protocols
- - [x] **VNC Streaming**: Watch browser automation in real-time
- - [x] **Async Tasks**: Execute browser operations asynchronously
- ## Local Development
- To develop and test the package locally:
- 1. Build a distributable wheel:
- ```bash
- # From the project root directory
- uv build
- ```
- 2. Install it as a global tool:
- ```bash
- uv tool uninstall browser-use-mcp-server 2>/dev/null || true
- uv tool install dist/browser_use_mcp_server-*.whl
- ```
- 3. Run from any directory:
- ```bash
- # Set your OpenAI API key for the current session
- export OPENAI_API_KEY=your-api-key-here
- # Or provide it inline for a one-time run
- OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
- ```
- 4. After making changes, rebuild and reinstall:
- ```bash
- uv build
- uv tool uninstall browser-use-mcp-server
- uv tool install dist/browser_use_mcp_server-*.whl
- ```
- ## Docker
- Using Docker provides a consistent and isolated environment for running the server.
- ```bash
- # Build the Docker image
- docker build -t browser-use-mcp-server .
- # Run the container with the default VNC password ("browser-use")
- # --rm ensures the container is automatically removed when it stops
- # -p 8000:8000 maps the server port
- # -p 5900:5900 maps the VNC port
- docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server
- # Run with a custom VNC password read from a file
- # Create a file (e.g., vnc_password.txt) containing only your desired password
- echo "your-secure-password" > vnc_password.txt
- # Mount the password file as a secret inside the container
- docker run --rm -p8000:8000 -p5900:5900 \
- -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
- browser-use-mcp-server
- ```
- *Note: The `:ro` flag in the volume mount (`-v`) makes the password file read-only inside the container for added security.*
- ### VNC Viewer
- ```bash
- # Browser-based viewer
- git clone https://github.com/novnc/noVNC
- cd noVNC
- ./utils/novnc_proxy --vnc localhost:5900
- ```
- Default password: `browser-use` (unless overridden using the custom password method)
- <div align="center">
- <img width="428" alt="VNC Screenshot" src="https://github.com/user-attachments/assets/45bc5bee-418d-4182-94f5-db84b4fc0b3a" />
- <br><br>
- <img width="428" alt="VNC Screenshot" src="https://github.com/user-attachments/assets/7db53f41-fc00-4e48-8892-f7108096f9c4" />
- </div>
- ## Example
- Try asking your AI:
- ```text
- open https://news.ycombinator.com and return the top ranked article
- ```
- ## Support
- For issues or inquiries: [cobrowser.xyz](https://cobrowser.xyz)
- ## Star History
- <div align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date" />
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date" />
- </picture>
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.