Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kontext-security--browser-use-mcp-server/badge.svg)](/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

i

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)

  1. # browser-use-mcp-server
  2. <div align="center">
  3. [![Twitter URL](https://img.shields.io/twitter/url/https/twitter.com/cobrowser.svg?style=social&label=Follow%20%40cobrowser)](https://x.com/cobrowser)
  4. [![Discord](https://img.shields.io/discord/1351569878116470928?logo=discord&logoColor=white&label=discord&color=white)](https://discord.gg/gw9UpFUhyY)
  5. [![PyPI version](https://badge.fury.io/py/browser-use-mcp-server.svg)](https://badge.fury.io/py/browser-use-mcp-server)
  6. **An MCP server that enables AI agents to control web browsers using
  7. [browser-use](https://github.com/browser-use/browser-use).**
  8. > **🌐 Want to Vibe Browse the Web?** Open-source AI-powered web browser - [**Vibe Browser**](https://github.com/co-browser/vibe).
  9. >
  10. > **🔗 Managing multiple MCP servers?** Simplify your development workflow with [agent-browser](https://github.com/co-browser/agent-browser)
  11. </div>
  12. ## Prerequisites
  13. - [uv](https://github.com/astral-sh/uv) - Fast Python package manager
  14. - [Playwright](https://playwright.dev/) - Browser automation
  15. - [mcp-proxy](https://github.com/sparfenyuk/mcp-proxy) - Required for stdio mode
  16. ```bash
  17. # Install prerequisites
  18. curl -LsSf https://astral.sh/uv/install.sh | sh
  19. uv tool install mcp-proxy
  20. uv tool update-shell
  21. ```
  22. ## Environment
  23. Create a `.env` file:
  24. ```bash
  25. OPENAI_API_KEY=your-api-key
  26. CHROME_PATH=optional/path/to/chrome
  27. PATIENT=false # Set to true if API calls should wait for task completion
  28. ```
  29. ## Installation
  30. ```bash
  31. # Install dependencies
  32. uv sync
  33. uv pip install playwright
  34. uv run playwright install --with-deps --no-shell chromium
  35. ```
  36. ## Usage
  37. ### SSE Mode
  38. ```bash
  39. # Run directly from source
  40. uv run server --port 8000
  41. ```
  42. ### stdio Mode
  43. ```bash
  44. # 1. Build and install globally
  45. uv build
  46. uv tool uninstall browser-use-mcp-server 2>/dev/null || true
  47. uv tool install dist/browser_use_mcp_server-*.whl
  48. # 2. Run with stdio transport
  49. browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
  50. ```
  51. ## Client Configuration
  52. ### SSE Mode Client Configuration
  53. ```json
  54. {
  55. "mcpServers": {
  56. "browser-use-mcp-server": {
  57. "url": "http://localhost:8000/sse"
  58. }
  59. }
  60. }
  61. ```
  62. ### stdio Mode Client Configuration
  63. ```json
  64. {
  65. "mcpServers": {
  66. "browser-server": {
  67. "command": "browser-use-mcp-server",
  68. "args": [
  69. "run",
  70. "server",
  71. "--port",
  72. "8000",
  73. "--stdio",
  74. "--proxy-port",
  75. "9000"
  76. ],
  77. "env": {
  78. "OPENAI_API_KEY": "your-api-key"
  79. }
  80. }
  81. }
  82. }
  83. ```
  84. ### Config Locations
  85. | Client | Configuration Path |
  86. | ---------------- | ----------------------------------------------------------------- |
  87. | Cursor | `./.cursor/mcp.json` |
  88. | Windsurf | `~/.codeium/windsurf/mcp_config.json` |
  89. | Claude (Mac) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
  90. | Claude (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
  91. ## Features
  92. - [x] **Browser Automation**: Control browsers through AI agents
  93. - [x] **Dual Transport**: Support for both SSE and stdio protocols
  94. - [x] **VNC Streaming**: Watch browser automation in real-time
  95. - [x] **Async Tasks**: Execute browser operations asynchronously
  96. ## Local Development
  97. To develop and test the package locally:
  98. 1. Build a distributable wheel:
  99. ```bash
  100. # From the project root directory
  101. uv build
  102. ```
  103. 2. Install it as a global tool:
  104. ```bash
  105. uv tool uninstall browser-use-mcp-server 2>/dev/null || true
  106. uv tool install dist/browser_use_mcp_server-*.whl
  107. ```
  108. 3. Run from any directory:
  109. ```bash
  110. # Set your OpenAI API key for the current session
  111. export OPENAI_API_KEY=your-api-key-here
  112. # Or provide it inline for a one-time run
  113. OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
  114. ```
  115. 4. After making changes, rebuild and reinstall:
  116. ```bash
  117. uv build
  118. uv tool uninstall browser-use-mcp-server
  119. uv tool install dist/browser_use_mcp_server-*.whl
  120. ```
  121. ## Docker
  122. Using Docker provides a consistent and isolated environment for running the server.
  123. ```bash
  124. # Build the Docker image
  125. docker build -t browser-use-mcp-server .
  126. # Run the container with the default VNC password ("browser-use")
  127. # --rm ensures the container is automatically removed when it stops
  128. # -p 8000:8000 maps the server port
  129. # -p 5900:5900 maps the VNC port
  130. docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server
  131. # Run with a custom VNC password read from a file
  132. # Create a file (e.g., vnc_password.txt) containing only your desired password
  133. echo "your-secure-password" > vnc_password.txt
  134. # Mount the password file as a secret inside the container
  135. docker run --rm -p8000:8000 -p5900:5900 \
  136. -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
  137. browser-use-mcp-server
  138. ```
  139. *Note: The `:ro` flag in the volume mount (`-v`) makes the password file read-only inside the container for added security.*
  140. ### VNC Viewer
  141. ```bash
  142. # Browser-based viewer
  143. git clone https://github.com/novnc/noVNC
  144. cd noVNC
  145. ./utils/novnc_proxy --vnc localhost:5900
  146. ```
  147. Default password: `browser-use` (unless overridden using the custom password method)
  148. <div align="center">
  149. <img width="428" alt="VNC Screenshot" src="https://github.com/user-attachments/assets/45bc5bee-418d-4182-94f5-db84b4fc0b3a" />
  150. <br><br>
  151. <img width="428" alt="VNC Screenshot" src="https://github.com/user-attachments/assets/7db53f41-fc00-4e48-8892-f7108096f9c4" />
  152. </div>
  153. ## Example
  154. Try asking your AI:
  155. ```text
  156. open https://news.ycombinator.com and return the top ranked article
  157. ```
  158. ## Support
  159. For issues or inquiries: [cobrowser.xyz](https://cobrowser.xyz)
  160. ## Star History
  161. <div align="center">
  162. <picture>
  163. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date&theme=dark" />
  164. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date" />
  165. <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=co-browser/browser-use-mcp-server&type=Date" />
  166. </picture>
  167. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.