Playwright Browser Skill MCP Server

关键词

浏览器自动化PlaywrightJSON-RPC服务端实现OpenClaw

使用说明（Markdown格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP 的服务器端，允许 LLM 客户端通过 JSON-RPC 方式读取资源、注册并调用浏览器自动化工具、以及定义和渲染提示等能力。核心功能以 Playwright 为底层浏览器自动化引擎，提供完整的浏览器操作工具集合。

  • 主要功能点

    • MCP 服务器：使用 Model Context Protocol（MCP）标准，通过标准化的 JSON-RPC 请求响应与客户端通信。
    • 工具注册与执行：提供超过100个浏览器操作工具（如浏览器启动、导航、元素交互、数据提取、网络控制等），客户端可通过工具名称调用对应实现。
    • Playwright 集成：内部实现了基于 Playwright 的浏览器自动化能力，支持多浏览器、无头/有头模式、设备模拟、截图、日志、存储等能力。
    • 会话与状态管理：支持打开/关闭浏览器、创建/切换页面、获取页面信息、执行自定义脚本等。
    • MCP 服务器与传输：通过 Stdio 传输实现，服务器可通过标准输入输出与 MCP 客户端通信，便于在多种环境集成。

  • 安装步骤

    • 克隆仓库并安装依赖
    • 构建项目（如使用 TypeScript，需编译生成 dist 目录）
    • 启动 MCP 服务器（通过 Node 运行 dist/mcp-server.js）
    • MCP 客户端配置并连接（参见下面的服务器配置示例）

  • 服务器配置 MCP 客户端需要的最小配置信息用于连接与使用该服务器。下面给出可用于客户端配置的描述信息，描述了服务器名称、启动命令及参数等，便于客户端在本地或服务器环境中启动与 MCP 服务器对接。该信息来自仓库实现的实际服务器设置，确保可与 MCP 客户端对接。

    服务器名称: "playwright-browser-skill" 启动命令: "node" 启动参数: ["dist/mcp-server.js"] 传输方式: "stdio"（通过标准输入输出进行 JSON-RPC 通信） 备注: MCP 客户端通过该配置启动服务器并建立连接，服务器启动后会输出已注册工具数量等信息，便于调试与确认。

  • 基本使用方法

    • 构建与启动
      • 使用 TypeScript 的项目通常需要安装依赖、构建生成 dist 目录，然后通过 node dist/mcp-server.js 启动服务器。
    • 连接与调用
      • MCP 客户端按 MCP 标准向服务器发送 ListTools 请求以获取可用工具列表，然后通过 CallTool 请求调用具体工具（如 browser_launch、browser_goto 等）。
    • 运行与测试
      • 服务器启动后，客户端即可通过 MCP 的工具列表与调用接口进行交互，实现浏览器操作自动化任务。
    • 调试
      • 服务器启动时会输出日志信息，包含已注册工具数量等关键状态，便于排查连接与调用问题。

  • 注意事项

    • 服务器实现中包含对 Playwright 的完整封装，实际操作时请确保环境中已安装所需依赖并具备运行所需的浏览器驱动。
    • 由于 MCP 的客户端实现可能会对请求格式有一定要求，请确保 ListTools 与 CallTool 的请求参数符合工具定义的输入模式。

服务器信息

访问项目