Agent Browser

<div align="center">

Accelerate development by managing all your MCP server in one place

Installation •
Client Integration •
API Documentation •
Development

</div>

---

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.

<div align="center">
<table>
<tr>
<th>Without Agent Browser</th>
<th>With Agent Browser</th>
</tr>
<tr>
<td>
<table>
<tr>
<td>
✓ Add new server in Cursor<br>
✓ Add new server in Windsurf Client<br>
✓ Add new server in Claude Client<br>
✓ Repeat for each additional client<br>
✓ Update all clients when server changes
</td>
</tr>
</table>
</td>
<td>
<table>
<tr>
<td>
✓ Add new server once in Agent Browser UI<br>
✓ Update once in Agent Browser when server changes
</td>
</tr>
</table>
</td>
</tr>
</table>
</div>

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

<details>
<summary><b>Direct Download</b></summary>
<br>

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.
</details>

---

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

<details>
<summary><b>View Project Structure</b></summary>
<br>

/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

Setup and Run

```bash