MCP Browser
About
NeoForge Browser MCP server - used to test the frontend
Details
- Author
- neoforge-dev
- GitHub stars
- 2
- Downloads
- 332
- Categories
- Automation, Web Scraping
Jump to
- Headless browser automation using Playwright
- Web UI for browser interaction
- WebSocket communication for real-time updates
- Real-time browser event subscription system
- Integration with MCP for AI agents
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP BrowserCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via one-line command or manually with Python 3.13+ and uv. Run locally using ./simple_test.sh or ./test_local.sh, or deploy with Docker Compose after setting MCP_SECRET. Configure via environment variables like MCP_SECRET, SERVER_PORT, and PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp browser": {
"mcp-browser": {
"command": "uv",
"args": [
"venv",
".venv"
]
}
}
}
}McpServers
{
"mcp-browser": {
"command": "uv",
"args": [
"venv",
".venv"
]
}
}MCP Browser
A headless browser interface for the Model Control Protocol (MCP).
Features
- Headless browser automation using Playwright
- Web UI for browser interaction
- WebSocket communication for real-time updates
- Real-time browser event subscription system
- Integration with MCP for AI agents
Prerequisites
- Python 3.13+
- uv for dependency management
- Docker (for containerized usage)
Installation
One-Line Installation
To install MCP Browser on your Mac with one command:
curl -sSL https://raw.githubusercontent.com/neoforge-dev/mcp-browser/main/install_one_line.sh | bash
This command will download and run the installer with proper line ending handling to avoid common issues.
Manual Installation
For manual installation:
1. Clone this repository
2. Run the installer script:
git clone https://github.com/neoforge-dev/mcp-browser.git
cd mcp-browser
./install.sh
XQuartz Requirements
MCP Browser requires XQuartz (X11) for proper visualization. The installer will:
1. Check if XQuartz is already installed and install it if needed
2. Attempt to start the X11 server in various ways
3. Prompt you to start it manually if automatic methods fail
If you encounter issues, see the Troubleshooting XQuartz Issues section.
Local Development
Setup with uv
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
