返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端