MCP.so
Sign In

MCP Browser

@neoforge-dev

Repository

About MCP Browser

NeoForge Browser MCP server - used to test the frontend

Basic information

Category

Browser Automation

Runtime

python

Transports

stdio

Publisher

neoforge-dev

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-browser": {
      "command": "uv",
      "args": [
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Browser?

MCP Browser is a headless browser interface for the Model Control Protocol (MCP) that uses Playwright for browser automation. It provides a Web UI for browser interaction and WebSocket communication for real-time updates, designed for integration with AI agents.

How to use MCP Browser?

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.

Key features of MCP Browser

  • 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

Use cases of MCP Browser

  • AI agents automating web browsing tasks
  • Real-time monitoring of browser events for testing
  • Headless browser control through MCP protocols
  • Live DOM, console, and network event inspection

FAQ from MCP Browser

What are the prerequisites for MCP Browser?

Python 3.13+, uv for dependency management, and Docker (for containerized usage). XQuartz (X11) is required for visualization on Mac.

How do I install MCP Browser?

Use the one-line installation command curl -sSL https://raw.githubusercontent.com/neoforge-dev/mcp-browser/main/install_one_line.sh | bash or clone the repo and run ./install.sh.

What environment variables does MCP Browser use?

MCP_SECRET for authentication, SERVER_PORT (default 7665), and PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD to skip browser download for headless-only mode.

How does real-time browser event subscription work?

Clients can subscribe to browser events via WebSocket endpoints like /ws/browser/events and receive page, DOM, console, and network events as they happen.

What APIs does MCP Browser expose?

It exposes a Web UI at GET /, a status endpoint at GET /api/status, WebSocket endpoints for real-time communication, and endpoints for subscribing and unsubscribing to browser events.

Comments

More Browser Automation MCP servers

Scrapling Fetch MCP

cyberchitta

Helps AI assistants access text content from bot-protected websites. MCP server that fetches HTML/markdown from sites with anti-automation measures using Scrapling.

101

browser-mcp

djyde

A browser extension and MCP server that allows you to interact with the browser you are using.

83

Webpage Screenshot MCP Server

ananddtyagi

An MCP that gives your agent the ability to snap a screenshot of webpages. Useful when you want your agent to check its progress during development.

58

Playwright MCP Server 🎭

executeautomation

Playwright Model Context Protocol Server - Tool to automate Browsers and APIs in Claude Desktop, Cline, Cursor IDE and More 🔌

5.6K

Puppeteer MCP Server

merajmehrabi

This MCP server provides browser automation capabilities through Puppeteer, allowing interaction with both new browser instances and existing Chrome windows.

474