📦

Agent Browser

MCP server for browser automation via Vercel's agent-browser CLI

0 installs

57 stars

4 forks

Trust: 62 — Good

Devtools

Installation

npx agent-browser

Ask AI about Agent Browser

I know everything about Agent Browser. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

Agent Browser

Version

Accelerate development by managing all your MCP server in one place

Installation • Client Integration • API Documentation • Development

Overview

Agent Browser eliminates the need to configure each MCP server in every client. Connect your clients once to Agent Browser, and it will manage all your Server-Sent Events (SSE) MCP servers for you.

Without Agent Browser

With Agent Browser

✓ Add new server in Cursor
✓ Add new server in Windsurf Client
✓ Add new server in Claude Client
✓ Repeat for each additional client
✓ Update all clients when server changes

✓ Add new server once in Agent Browser UI
✓ Update once in Agent Browser when server changes

Usage

Access the web UI at http://localhost:8080/ui/ to:

View connection status of your MCP servers
Add new MCP server connections
Remove existing connections
Monitor connection health in real-time

Installation

Package Managers

macOS and Linux

brew tap cob-packages/homebrew-agent-browser
brew install cob-packages/agent-browser/agent-browser
agent-browser

Windows

scoop bucket add agent-browser https://github.com/cob-packages/scoop-agent-browser
scoop install agent-browser
agent-browser

Direct Download

You can also download the latest release directly from GitHub Releases:

Platform	Architecture	Download
macOS	Intel (x86_64)	`agent-browser-[version]-darwin-amd64.tar.gz`
macOS	Apple Silicon (M1/M2)	`agent-browser-[version]-darwin-arm64.tar.gz`
Linux	x86_64 (64-bit)	`agent-browser-[version]-linux-amd64.tar.gz`
Linux	ARM 64-bit	`agent-browser-[version]-linux-arm64.tar.gz`
Linux	ARM 32-bit	`agent-browser-[version]-linux-arm7.tar.gz`
Windows	64-bit	`agent-browser-[version]-windows-amd64.zip`
Windows	32-bit	`agent-browser-[version]-windows-386.zip`
Windows	ARM 64-bit	`agent-browser-[version]-windows-arm64.zip`

After downloading, extract the archive and run the executable.

Client Integration

Cursor

After installing and running Agent Browser, Cursor will automatically detect and connect to it. No additional configuration needed.

Other MCP Clients

Add Agent Browser as an SSE endpoint in your MCP client configuration:

{
  "Agent Browser": {
    "url": "http://localhost:8087/sse"
  }
}

Once your client is connected to Agent Browser, you can add or remove MCP servers without touching your client configurations.

Project Structure

View Project Structure

/cmd             - Application entry points
/internal
  /app           - Core application setup with Fx
  /backend       - Database and persistence layer
  /config        - Configuration management
  /cursor        - Cursor integration
  /events        - Event bus for internal communication
  /log           - Logging utilities
  /mcp           - MCP server implementation
  /web           - Web server and UI
/scripts         - Build and utility scripts
/out             - Compiled binaries (git-ignored)

API Documentation

The Agent Browser exposes a REST API for integration. For details on accessing the API documentation, using Swagger UI, or integrating with tools like Postman, see API.md.

Future Direction

Protocol Support Implementation

We plan to expand Agent Browser to support additional protocols alongside MCP.

Future Tasks

Add A2A protocol support
Add ACP protocol support
Implement protocol auto-detection

      Client
         │
         ▼
   Agent Browser
    /    │    \
   /     │     \
  ▼      ▼      ▼
 MCP    A2A    ACP  ...

Relevant Files

/internal/mcp - MCP protocol implementation
/internal/web - Web server and UI components
/internal/config - Configuration management

Development

Prerequisites

Go 1.21 or later
Bash (for setup scripts)

Setup and Run

# Clone the repository
git clone https://github.com/co-browser/agent-browser.git
cd agent-browser

# Install development tools
make setup

# Build and run
make run

The application will be available at http://localhost:8080.

Support

For issues or inquiries: cobrowser.xyz