关键词

文件操作浏览器自动化AI 辅助开发幻觉防控快照回滚

使用说明（简明易懂，便于快速落地）：

  • 项目简介

    • FrontAgent 以 MCP 为通信协议，为 LLM 客户端提供可控的上下文服务。核心包含资源管理（如读取文件、创建补丁、搜索代码等工具）、工具注册与执行、以及提示模板（SDD）渲染等能力。仓库中实现了至少两个 MCP 服务器：一个用于文件操作工具（mcp-file），一个用于浏览器感知工具（mcp-web）。服务器通过 MCP 的标准请求/响应格式对外提供服务，并支持通过标准传输通道（如 Stdio）进行通信。

  • 主要功能点

    • MCP 服务器端实现与暴露的工具集合
      • 文件工具：read_file、apply_patch、create_file、search_code、list_directory、get_ast、rollback、get_snapshots
      • Web/浏览器工具：navigate、get_page_structure、get_accessibility_tree、get_interactive_elements、click、type、scroll、screenshot、wait_for_selector、evaluate、close_browser
    • 服务器端能力
      • 处理 MCP 请求与响应（JSON-RPC 风格的请求/响应）
      • 任务/步骤执行的管线：计划（Planner）、执行（Executor）、上下文管理（ContextManager）
      • 幻觉防控：在执行阶段对输出进行多层检查（文件存在性、导入有效性、语法有效性、SDD 合规性）
      • 回滚能力：基于快照回滚文件变更
      • 支持多工具多客户端的映射与调用
    • 运行环境与部署友好性
      • 基于 TypeScript/Node.js 构建，提供清晰的模块分层和服务器入口
      • 具备示例化 CLI 及服务端代码结构，便于在本地或容器中搭建

  • 安装步骤

    • 安装与构建通常包含：安装依赖、构建打包、启动 MCP 服务器进程等标准步骤（请参考仓库对应的构建脚本与 README 提示进行操作）。
    • 典型环境需求：Node.js 版本符合仓库要求，确保能编译 TypeScript 并运行 MCP 服务器。

  • 服务器配置（MCP 服务器配置示例，JSON 格式） 说明：MCP 客户端需要一个用于连接的 MCP 服务器配置。配置包含服务器名称、启动命令及其参数等信息。以下示例描述了两个服务器实例（文件工具服务器与网页/浏览器工具服务器）的配置要点，具体路径请按实际部署时的打包产物位置替换。

    • frontagent-file-server
      • name: frontagent-file-server
      • command: node
      • args: ["path/to/dist/mcp-file/server.js"] 说明：启动后将以 MCP 文件服务器对外暴露工具接口，提供 read_file、apply_patch、create_file、search_code、list_directory、get_ast、rollback、get_snapshots 等工具。
      • 注释：该服务器实现了对本地文件系统的受控访问与变更，含快照与回滚能力，便于在 LMpt（LLM）驱动的任务中进行安全的文件修改。
    • frontagent-web-server
      • name: frontagent-web-server
      • command: node
      • args: ["path/to/dist/mcp-web/server.js"] 说明：启动后将以 MCP Web 服务暴露浏览器相关工具，支持页面导航、结构/无障碍树、交互等能力。
      • 注释：用于在需要网页感知/自动化的任务中提供对浏览器的远程控制能力。
    • 注：以上 JSON 结构中的路径应指向实际部署环境中的可执行入口（打包后的 server.js 或等效入口）。MCP 客户端在连接时只需要读取 server name、启动命令与参数即可，无需额外的实现细节。

  • 基本使用方法

    • 启动服务器
      • 按照配置中的命令启动对应 MCP 服务器实例（例如：node dist/mcp-file/server.js 与 node dist/mcp-web/server.js）。
    • 客户端交互
      • 客户端通过 MCP 的 JSON-RPC 请求向对应服务器请求工具执行（如读取文件、导航、获取页面结构等），服务器返回标准的 JSON-RPC 响应或错误信息。
    • 运行流程要点
      • 服务器对外提供工具列表与调用入口，客户端可以查询可用工具、调用工具并接收结果。
      • 服务器端实现了会话管理、能力声明、以及对工具调用的前后验证与回滚支持，确保操作安全可控。
    • 安全与稳定
      • 文件相关操作具备路径安全检查（防止跨越根目录的访问）
      • 幻觉防控机制对工具输出进行多层校验，降低错误信息对后续决策的干扰
      • 具备快照/回滚能力，便于回退在执行过程中的不良变更

  • 进一步使用与扩展

    • 将 MCP 服务器接入到 FrontAgent 的 Agent-core 组件中，以实现端到端的计划、执行、反馈流程
    • 如需扩展新的 MCP 工具，只需实现新的工具描述和处理逻辑，并在服务器中注册即可

  • 关键词 文件操作, 浏览器自动化, AI 辅助开发, 幻觉防控, 快照回滚

  • 分类ID 6

信息

分类

AI与计算

访问项目