Content
# Agent Browser
<div align="center">
[](https://x.com/cobrowser)
[](https://discord.gg/gw9UpFUhyY)
**Accelerate development by managing all your MCP server in one place**
[Installation](#installation) •
[Client Integration](#client-integration) •
[API Documentation](#api-documentation) •
[Development](#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/](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**
```bash
brew tap cob-packages/homebrew-agent-browser
brew install cob-packages/agent-browser/agent-browser
agent-browser
```
**Windows**
```bash
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](https://github.com/faintaccomp/agent-browser/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:
```json
{
"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)
```
</details>
---
## 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](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
```bash
# Clone the repository
git clone https://github.com/faintaccomp/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](https://cobrowser.xyz)
