Brave Real Browser MCP Server

使用说明（简要版，便于开发者上手）：

• 项目简介
  • Brave Real Browser MCP Server 是一个完整的 MCP 服务器实现，除了提供23个优化后的浏览器自动化工具外，还包含与 LSP 服务器、AI 自动增强模块、资源与模板等协同工作能力，旨在为 LLM 客户端提供标准化的上下文与功能服务。
• 主要功能点
  • MCP Server：以标准化的 JSON-RPC 交互向客户端暴露工具、资源和提示模板。
  • 23 个工具集：对 Brave/浏览器自动化的核心操作如 browser_init、navigate、get_content、click、type、solve_captcha 等等，便于 LLM 客户端直接调用。
  • 资源与数据访问：资源管理和数据提取能力，方便 LLM 获取必要上下文。
  • 提示模板与渲染：支持自定义的 Prompt 模板，以灵活控制与 LLM 的交互流程。
  • AICore 自动增强：对工具调用进行自适应优化、错误修复和智能重试。
  • 多传输协议支持：STDIO、WebSocket、SSE 等传输实现，确保与不同客户端的互操作性。
  • Monorepo 架构：包含 MCP 服务端、LSP 服务、以及浏览器/AI 相关的核心组件，便于扩展和维护。
• 安装步骤
  • 前提：Node.js 版本 >= 18。
  • 1. 在项目根或工作区中安装 MCP 服务器包：
    • npm install brave-real-browser-mcp-server
  • 2. 启动 MCP 服务端（默认以 MCP Server 启动）：
    • npm run dev
    • 或使用根入口直接启动：node dist/index.js mcp
• 服务器配置（供 MCP 客户端使用的配置示例，非代码，仅供参考）
  • 服务器名称: brave-browser
  • 启动命令与参数（客户端需要提供，用于在本地或远程启动 MCP 服务器）
  • 配置示例（JSON，需客户端提供给 MCP 服务器以建立连接；此处仅描述字段含义，具体JSON结构以客户端实现为准） { "serverName": "brave-browser", "command": "npx", "args": ["brave-real-browser-mcp-server"] }
  • 说明：上述配置用于 MCP 客户端在其启动阶段通过命令行启动 MCP 服务器进程。MCP 客户端需要的是服务器的名称、启动命令和参数信息，以便能够在运行时启动并建立 JSON-RPC 通道进行后续交互。
• 基本使用方法
  • 启动后，LLM 客户端通过 JSON-RPC 调用以下能力：
    • 读取或写入 Resources，获取上下文数据。
    • 注册与调用 Tools，执行浏览器自动化任务（如 browser_init、navigate、click、type 等）。
    • 请求 Prompts 的渲染与获取，作为对话上下文的一部分。
  • 实践示例（概览性步骤，非代码）
    • 通过 MCP 客户端配置 braver-browser 服务端信息并建立连接。
    • 调用 browser_init 启动 Brave 浏览器并建立会话上下文。
    • 使用 navigate 跳转到目标页面，结合 AI-Heal 和 Smart Retry 实现稳健导航。
    • 通过 media_extractor、link_harvester 等工具提取页面信息，形成后续决策上下文。
    • 通过 prompt 模板获取对话式上下文，驱动后续的 LLM 推理与行动。
• 补充说明
  • MCP 服务端由多个包共同支撑（MCP 服务端、LSP 服务、AI Core、浏览器核心、Blocker 等），具备可扩展性与可观测性，适用于需要对 LLM 客户端提供安全、可控、可扩展的上下文服务的场景。