Back to MCP directory
publicPublicdnsLocal runtime

agent-browser

Agent Browser是一个集中管理MCP服务器的工具,通过统一界面管理多个客户端连接,简化服务器配置和更新流程。

article

README

🚀 代理浏览器

代理浏览器能够让开发者在一处管理所有MCP服务器,有效加速开发进程,避免在每个客户端单独配置MCP服务器的繁琐操作。

版本 许可证 Twitter链接 Discord

安装客户端集成API文档开发

🚀 快速开始

代理浏览器消除了在每个客户端配置每个MCP服务器的需要。只需将客户端一次性连接到代理浏览器,它即可为您管理所有的SSE MCP服务器。

以下通过表格对比有无代理浏览器的情况: | 无代理浏览器 | 有代理浏览器 | | ---- | ---- | | ✓ 在Cursor中添加新服务器
✓ 在Windsurf客户端中添加新服务器
✓ 在Claude客户端中添加新服务器
✓ 在每个客户端重复此操作 | ✓ 一次性将所有客户端连接到代理浏览器
✓ 代理浏览器自动管理所有MCP服务器 |

📦 安装指南

系统要求

  • 操作系统:支持Go语言的任何操作系统(Windows、Linux、macOS)
  • 内存:至少2GB RAM
  • 存储:至少10GB可用磁盘空间

安装步骤

  1. 下载最新二进制文件:
    wget https://github.com/co-browser/agent-browser/releases/download/v1.0.0/agent-browser_<os>_<arch>.tar.gz
    
  2. 解压并安装:
    tar -xzf agent-browser_<os>_<arch>.tar.gz
    ./install.sh
    
  3. 启动代理浏览器:
    agent-browser start
    

配置

默认配置文件位于/etc/agent-browser/config.yml。您可以通过编辑此文件来调整端口、日志级别和其他设置。

💻 使用示例

支持的协议

  • MCP协议
  • A2A协议
  • ACP协议

基础用法

在客户端中集成代理浏览器的基础步骤如下:

  1. 在客户端中添加代理浏览器依赖:
    import "github.com/co-browser/agent-client-go"
    
  2. 初始化代理客户端:
    client := agent_client_go.NewClient("http://localhost:8080")
    
  3. 连接到代理服务器:
    err := client.Connect()
    if err != nil {
        // 处理错误
    }
    

高级用法

以下是一个完整的示例代码,展示了如何使用代理浏览器:

package main

import (
    "github.com/co-browser/agent-client-go"
)

func main() {
    client := agent_client_go.NewClient("http://localhost:8080")
    err := client.Connect()
    if err != nil {
        panic(err)
    }
    // 连接成功,开始使用代理服务器
}

📚 详细文档

代理浏览器提供REST API用于集成。请参阅API.md获取详细信息,包括Swagger UI和Postman的使用说明。

🔧 技术细节

未来方向

协议支持实施

我们计划扩展代理浏览器以支持更多的协议。

未来任务

  • [ ] 添加A2A协议支持
  • [ ] 添加ACP协议支持
  • [ ] 实现协议自动检测
      客户端
         │
         ▼
   代理浏览器
    /    │    \
   /     │     \
  ▼      ▼      ▼
 MCP    A2A    ACP  ...

相关文件

  • /internal/mcp - MCP协议实现
  • /internal/web - Web服务器和UI组件
  • /internal/config - 配置管理

开发

先决条件

  • Go 1.21或更高版本
  • Bash(用于设置脚本)

设置与运行

# 克隆仓库
git clone https://github.com/co-browser/agent-browser.git
cd agent-browser

# 安装开发工具
make setup

# 构建并运行
make run

应用程序将在http://localhost:8080可用。

📄 许可证

本项目采用MIT许可证。

🌟 支持

如有问题或疑问,请联系cobrowser.xyz

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client