使用说明内容(Markdown格式)
- 项目简介
- BrowserWing 的 MCP 服务器实现,作为后端服务端,向 LLM 客户端以标准化的 JSON-RPC 方式暴露能力,支持注册并执行 MCP 命令、管理工具、以及渲染和提供提示模板等上下文信息,以帮助模型在浏览器自动化场景中进行跨系统协作。
- 主要功能点
- MCP 协议核心处理:实现 MCP 请求/响应格式(如 initialize、tools/list、tools/call 等),通过 JSON-RPC 与客户端交互。
- 工具/命令注册与执行:维护可用 MCP 工具清单,注册并执行脚本化命令,执行结果通过 MCP 响应返回。
- 与浏览器/自动化模块集成:与 Browser 模块对接,执行脚本/命令以驱动浏览器自动化任务,并返回执行结果和可能的提取数据。
- 会话与状态管理:在服务内部维持命令执行上下文和状态信息,支持对外暴露的状态接口。
- 多传输协议支持(如 STDIO、SSE、HTTP):服务器端具备多种传输模式以满足不同场景的通信需求。
- 安装与运行
- 构建与运行:在仓库根目录,使用 Go 构建后端组件,然后启动 MCP 服务器进程,使其对外提供 MCP 服务接口。
- 运行前提:需要 Golang 环境以及本仓库其他后端组件的运行依赖(如浏览器管理、LLM 管理、存储等)。
- 启动参数与配置将通过配置文件或命令行传递,确保 MCP 服务器可以与客户端建立连接。
- 服务器配置(对 MCP 客户端的说明,非客户端代码)
- 说明:MCP 客户端需要向 MCP 服务器提供一个启动配置,以便建立连接并使用 MCP 服务。配置的核心字段包括服务器名称(server_name)、启动命令(command)以及命令参数(args)。该信息用于客户端在启动时展示与连接服务器的必要信息,并告知如何通过该服务器进行命令交互。
- 配置字段描述(JSON 结构描述,非代码块形式):
- server_name: BrowserWing MCP Server
- 服务器在客户端侧显示的名称,便于区分与管理。
- command: browserwing-mcp-server
- 启动 MCP 服务器的可执行名称,客户端通过该名称知晓如何启动服务。
- args: ["--port","8080","--config","config.toml"]
- 启动命令所携带的参数,例如端口、配置文件路径等,确保 MCP 服务能够正确绑定并加载配置。
- server_name: BrowserWing MCP Server
- 备注:MCP 客户端实际使用中通常不需要在应用内编码依赖,只需知道服务器的地址、端口以及启动参数的含义即可完成集成。请使用上述描述信息在客户端配置阶段对接即可。
- 基本使用方法
- 第一步:部署与启动
- 启动后端 MCP 服务,让其监听指定端口,并加载必要的配置信息。
- 第二步:客户端连接
- MCP 客户端通过 JSON-RPC 与服务器建立通信,调用 initialize 获取能力、调用 tools/list 获取可用工具、通过 tools/call 执行指定工具等。
- 第三步:调用示例(描述性)
- 客户端通过 initialize 了解服务器能力与版本信息;
- 调用 tools/list 获取可用 MCP 工具及其输入模式;
- 通过 tools/call 提供工具名称和参数,服务器执行对应脚本并返回结果。
- 第四步:扩展与监控
- 服务支持多传输通道(STDIO/SSE/HTTP),可按应用场景切换传输模式,并可通过管理接口监控工具状态和执行结果。
- 第一步:部署与启动
信息
分类
AI与计算