Browser Debug MCP Bridge 服务器

关键词

浏览器调试资源管理工具执行上下文协议本地桥接

使用说明内容（Markdown格式）

  • 项目简介

    • 这是一个以 MCP（Model Context Protocol）为核心的服务器端实现，旨在向大模型客户端提供浏览器调试所需的上下文信息、资源数据、以及可调用的工具，帮助实现对真实浏览器会话的分析与自动化工作流。

  • 主要功能点

    • 资源与数据管理：托管并查询浏览器会话中的资源与事件数据，支持按会话、URL、时间等维度过滤。
    • 工具注册与执行：暴露用于查询、网络请求分析、DOM 快照等工具，LLM 客户端可发送调用请求并接收结果。
    • Prompt 模板与渲染支持：提供可解析的提示模板与交互模式，便于与 LLM 进行可定制对话。
    • JSON-RPC 通信：服务器通过标准的 JSON-RPC 形式接收请求并返回响应，支持多种传输方式（如 StdIO/WebSocket）。
    • 会话与架构管理：处理会话创建、绑定标签页、隐私保护设置、以及数据存储与清理等运行时职责。

  • 安装步骤

    • 获取代码并进入项目根目录。
    • 本地开发环境需具备 Node.js（>= 20）、pnpm 等工具。
    • 构建与启动分两步（局部开发常用方式）：
      • 构建 MCP 服务器（本地仓库模式）
        • pnpm nx build mcp-server
      • 启动 MCP 服务器（默认端口 8065，示例命令如下）
        • node scripts/mcp-start.cjs
    • 也可以通过快速模式直接全局运行（需全局安装包并遵循仓库提供的快速启动指引）。

  • 服务器配置 服务器配置用于 MCP 客户端在启动时指定服务器对象、命令及参数等信息。一个准确的示例配置信息（JSON 格式，不用动代码）： { "serverName": "browser-debug-mcp-bridge", "version": "1.0.0", "command": "node", "args": [ "scripts/mcp-start.cjs" ], "host": "127.0.0.1", "port": 8065 } 说明：

    • serverName：服务器名称，便于在客户端配置中标识。
    • version：当前服务器版本，便于维护与对比。
    • command、args：启动 MCP 服务器所需的命令及参数。这里指向仓库中的启动脚本。
    • host、port：服务器绑定的地址与端口，客户端需按照该端口建立连接。

  • 基本使用方法

      1. 启动服务器：在项目根目录执行启动脚本（如 node scripts/mcp-start.cjs），确保本地环境中 Node 已就位且端口可用。
      1. 配置 MCP 客户端：在客户端配置中指定服务器的命令与参数，确保客户端能够通过 JSON-RPC 调用服务器提供的工具、读取资源与获取 Prompts。
      1. 客户端交互：
      • 读取资源：通过工具调用查询会话资源与事件数据。
      • 调用工具：向服务器注册并执行工具，获取执行结果。
      • 获取 Prompt：请求并渲染提示模板以引导对话。
      1. 会话与隐私控制：服务器负责会话上下文管理以及隐私策略（如 safe mode/redaction）在数据流中的应用。
      1. 运行与扩展：服务器设计为可扩展，支持多传输通道（如 StdIO、WebSocket、SSE）以适配不同客户端实现。

服务器信息

访问项目