Browser Bridge MCP Server
- 项目简介
- 该仓库实现了一个完整的 MCP 服务器端框架,用于将复杂的浏览器环境能力暴露给基于 MCP 的客户端(如 LLM 驱动的代理)。通过资源、工具和断言提示的标准化接口,LLM 客户端可以读取资源、调用工具、获取并渲染 Prompt,以实现可控、可扩展的对话式上下文服务。
- 主要功能点
- MCP 核心能力:实现对 MCP 相关请求的处理、响应封装及错误映射,支持资源、工具、提示模板等核心实体的管理。
- 资源与提示:提供对“资源”(如截图、HAR、日志等)的管理与访问,以及对 Prompt/模板的渲染与获取能力。
- 工具注册与执行:提供工具工具集的注册、调用和结果回传机制,支持将外部功能暴露给 LLM 客户端。
- 会话与状态管理:内置会话注册表、状态转移、错误重试策略等,确保在多车道并发场景下的可靠性。
- 多协议适配与桥接:通过与 Core/MCP Adapter/Extension 的桥接实现对核心能力的访问,支持多种传输与通信场景。
- 诊断与可观测性:提供诊断路由、运行时元数据、Artifact 写入、日志和错误传播等能力,便于运维与调试。
- 安装步骤
- 克隆并安装依赖:在项目根目录执行依赖安装命令。
- 构建与打包:执行构建流程,将 TypeScript/TS 项目编译为可运行的服务形态。
- 启动 MCP 服务器:使用仓库提供的 MCP 启动命令(示例性说明在后文配置中给出)。
- 服务器配置(MCP 客户端与 MCP 服务器的连接信息)
- 说明:MCP 客户端需要一个服务器来建立连接与通信,配置包含服务器名称、启动命令与参数等信息。以下为示例描述,实际请根据你的部署环境写出准确的 JSON 配置。
- server name: Browser Bridge MCP Server
- command: browser-bridge
- args: mcp
- 备注:该启动方式根据仓库中“MCP Server (Optional)”的说明设计,MCP 服务器通常以浏览器命令行形式启动,并通过标准输入输出(stdio)或其他 IPC 通道与 MCP 客户端对接。
- 注释:MCP 客户端无需关心实现细节,只需要知道服务器名称、启动命令和参数即可建立连接。
- 经典使用方法
- 在本地环境启动后,MCP 客户端将通过预定义的工具与资源 API 进行交互,开发者可通过 MCP 客户端向服务器发起请求,服务器返回相应的 JSON-RPC 风格响应或通知。
- 如需调试,可查看核心路由(session、drive、inspect、artifacts、diagnostics)的日志和诊断输出,确保 MCP 客户端与服务器之间的通信正常。