使用说明

项目简介

Agent Browser 是一款用于集中管理多个 Model Context Protocol (MCP) 服务器的工具。它作为一个统一的接入点,允许LLM客户端仅连接到 Agent Browser,即可访问和使用后端集成的所有MCP服务器的资源和工具,无需为每个客户端单独配置和管理多个服务器连接。

主要功能点

  • MCP 服务器管理: 集中管理多个 MCP 服务器连接,支持添加、移除和监控服务器状态。
  • 统一接入点: LLM 客户端只需配置连接 Agent Browser,即可访问所有已管理的 MCP 服务器的功能。
  • SSE 协议支持: 通过 Server-Sent Events (SSE) 协议与 LLM 客户端通信,实时推送服务器状态更新。
  • 工具代理和聚合: Agent Browser 聚合来自不同 MCP 服务器的工具,并统一提供给客户端调用。
  • Web UI 管理界面: 提供友好的 Web 用户界面,方便用户查看服务器状态、添加新连接和管理配置。
  • Cursor 集成: 与 Cursor 编辑器无缝集成,自动检测并连接 Agent Browser。
  • 多平台支持: 支持 macOS, Linux, Windows 等多种操作系统。

安装步骤

Agent Browser 提供了多种安装方式,以下是推荐的安装步骤:

通过包管理器安装 (macOS/Linux 推荐)

  1. macOS (Homebrew):

    brew tap cob-packages/homebrew-agent-browser
    brew install cob-packages/agent-browser/agent-browser
    agent-browser
  2. Linux (Homebrew on Linux 或直接下载): 请参考 https://github.com/co-browser/agent-browser#package-managers 中的 Linux 安装指南,或选择直接下载预编译的二进制文件。

  3. Windows (Scoop):

    scoop bucket add agent-browser https://github.com/cob-packages/scoop-agent-browser
    scoop install agent-browser
    agent-browser

直接下载安装

您也可以从 GitHub Releases 页面下载对应您操作系统的预编译版本: https://github.com/co-browser/agent-browser/releases 下载后解压,并运行可执行文件 'agent-browser'。

服务器配置

Agent Browser 作为一个 MCP 服务器,主要配置是其监听的端口。默认情况下,Agent Browser 监听 '8087' 端口,并通过 SSE 协议提供 MCP 服务。

对于 MCP 客户端,您需要配置连接到 Agent Browser 的地址。

MCP 客户端配置示例 (JSON):

以下是一个 MCP 客户端配置示例,展示如何配置连接到 Agent Browser。您需要将 Agent Browser 添加为一个 MCP 服务器连接。

{
  "Agent Browser": {
    "url": "http://localhost:8087/sse"  // Agent Browser 的 SSE 服务地址
  },
  // ... 其他 MCP 服务器配置 ...
}
  • url: Agent Browser 的 SSE 服务地址,通常为 'http://localhost:8087/sse'。请确保端口与 Agent Browser 实际运行端口一致。

基本使用方法

  1. 启动 Agent Browser 服务器: 根据安装步骤启动 Agent Browser。默认情况下,它将在 'http://localhost:8080' 启动 Web UI 管理界面,以及在 'http://localhost:8087/sse' 提供 MCP 服务。
  2. 访问 Web UI: 打开浏览器访问 'http://localhost:8080/ui/',您可以在 Web UI 中:
    • 查看已连接的 MCP 服务器状态。
    • 添加新的 MCP 服务器连接。
    • 移除现有的 MCP 服务器连接。
    • 监控连接健康状态。
  3. 配置 LLM 客户端: 在您的 LLM 客户端 (例如 Cursor, Windsurf Client, Claude Client 等) 中,将 Agent Browser 配置为一个 MCP 服务器连接,使用 'http://localhost:8087/sse' 作为服务器地址。
  4. 管理 MCP 服务器: 通过 Agent Browser 的 Web UI 添加和管理您希望 LLM 客户端访问的后端 MCP 服务器。添加后,客户端即可通过 Agent Browser 访问这些服务器提供的资源和工具,无需在客户端重新配置。

Cursor 编辑器集成

对于 Cursor 编辑器,Agent Browser 提供了自动集成,无需手动配置。启动 Agent Browser 后,Cursor 将自动检测并连接到 Agent Browser。

信息

分类

AI与计算