Agent Browser

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