使用说明

项目简介

AutoBrowser MCP Server 是一个 Model Context Protocol (MCP) 服务器的实现,它旨在为大型语言模型 (LLM) 应用提供与网页浏览器进行交互的能力。通过提供一系列预定义的工具,该服务器允许 LLM 控制浏览器行为,例如导航网页、点击元素、填写表单、以及获取网页快照和控制台日志等信息。这使得 LLM 能够执行更复杂的基于网页的任务,例如信息检索、自动化操作和用户界面交互。

主要功能点

  • 工具执行: 提供丰富的浏览器操作工具,包括:
    • 网页导航 (navigate, goBack, goForward)
    • 页面元素交互 (click, hover, type, selectOption, drag)
    • 页面信息获取 (snapshot, getConsoleLogs)
    • 基础操作 (wait, pressKey)
  • 资源管理: (当前仓库未实现资源管理功能,但框架已预留资源管理接口) 理论上可以扩展以管理和提供网页内容或其他类型的资源。
  • MCP 协议支持: 遵循 Model Context Protocol 标准,确保与兼容 MCP 客户端的互操作性。
  • 传输协议: 支持 Stdio 和 WebSocket 两种传输协议,方便不同场景下的客户端连接。

安装步骤

  1. 环境准备: 确保已安装 Node.js 和 npm (或 yarn)。
  2. 克隆仓库: 使用 Git 克隆仓库到本地:
    git clone https://github.com/autobrowser-ai/mcp
    cd mcp
  3. 安装依赖: 在仓库根目录下运行 npm 或 yarn 命令安装项目依赖:
    npm install
    yarn install
  4. 构建项目: (根据 README.md 提示,项目可能需要构建,但具体构建命令未提供,以下命令为推测,请根据实际情况调整) 尝试运行构建命令:
    npm run build
    yarn build
    如果 'package.json' 中定义了构建脚本,则会生成编译后的文件。如果未定义,可能需要跳过此步骤,直接运行 'index.ts'。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到 AutoBrowser MCP Server:

{
  "serverName": "AutoBrowser MCP Server",
  "command": "node",
  "args": ["dist/index.js"]
}
  • 'serverName': 服务器名称,可以自定义,用于在客户端标识服务器。
  • 'command': 启动服务器的命令,这里使用 'node' 运行 Node.js 程序。
  • 'args': 命令参数,指向服务器入口文件。 注意: 如果项目需要构建,并且构建输出目录为 'dist',则入口文件可能是 'dist/index.js'。如果无需构建,或者直接运行 'index.ts',则 'args' 应为 '["src/index.ts"]'。 请根据实际构建情况或直接运行源文件调整此参数。

基本使用方法

  1. 启动服务器: MCP 服务器在客户端发起连接时启动。无需手动预先启动服务器。
  2. 配置 MCP 客户端: 在 MCP 客户端 (例如,LLM 应用或 MCP 客户端 SDK) 中,配置上述服务器配置信息。
  3. 连接服务器: 客户端根据配置信息尝试连接到 MCP 服务器。服务器启动并等待客户端请求。
  4. 调用工具: 客户端可以使用 MCP 协议发送请求,调用服务器提供的工具。例如,调用 'snapshot' 工具获取网页快照,或调用 'click' 工具模拟点击网页元素。
  5. 接收响应: 服务器执行工具后,会将结果以 MCP 响应格式返回给客户端。

重要提示:

  • "Cannot be built as-is": 根据仓库 README.md 的说明,该仓库可能 "cannot be built as-is"。这意味着代码可能不完整或需要进一步配置才能运行。用户可能需要关注仓库的更新,或者自行解决构建问题。
  • 浏览器扩展依赖: 代码中 'src/context.ts' 提到了 "No connection to browser extension"。 这暗示 AutoBrowser MCP Server 依赖于一个浏览器扩展才能正常工作。 用户可能需要安装并配置 AutoBrowser 浏览器扩展才能使用此 MCP 服务器。具体的扩展安装和配置方法请参考 https://autobrowser.aihttps://docs.autobrowser.ai
  • 资源管理: 当前仓库提供的代码中,'resources' 数组为空,资源管理功能可能尚未实现或需要用户自行扩展。

信息

分类

网页与API