Claude-Playwright MCP 服务器

关键词

模型上下文协议浏览器自动化JSON-RPC 服务资源与工具管理提示模板渲染

使用说明（简要概览，便于快速上手）：

  1. 项目简介
  • 这是一个基于 Model Context Protocol 的 MCP 服务器实现，用于向 LLM 客户端提供资源管理、工具注册与执行、以及 Prompt 模板的渲染能力，具备 JSON-RPC 通信、会话管理、能力声明等后端服务特性，支持浏览器自动化等场景。
  1. 主要功能点
  • 资源与数据访问：托管与管理 Resources（如网页资源、缓存、会话状态等），提供数据访问能力。
  • 工具注册与执行：注册可被 LLM 调用的外部功能（工具），并在后端执行这些工具。
  • Prompt 模板定义与渲染：定义并渲染可定制的 Prompt 模板，支持多种交互模式。
  • JSON-RPC 通信：服务器与客户端通过 JSON-RPC 协议互相请求与响应。
  • 会话与能力声明：服务器端维护会话、能力与状态，便于客户端发现与协作。
  • 多传输协议扩展：理论上支持基于标准传输的扩展（如 Stdio、SSE、WebSocket 等）。
  • 集成 Playwright 的浏览器自动化工具，提供超过 26 种浏览器操作工具的支持。
  1. 安装步骤
  • 全局安装（快速使用）：
    • 全局安装 claude-playwright。
  • 项目本地安装（建议在项目中使用）：
    • 在项目中安装 claude-playwright 依赖。
  • 初始化 MCP 配置：
    • 使用 mcp 初始化配置，指定应用的基础 URL（BASE_URL），以便客户端连接。
  • 启动 Claude Code 并连接：
    • Claude Code 启动后，可以在代码提示或命令面板中看到已激活的 MCP 服务器。
  • 注意：MCP 客户端需要配置服务器启动信息（后续配置见下方“服务器配置”部分）。
  1. 服务器配置（针对 MCP 客户端的启动配置，配置示例已在仓库文档中梳理过）
  • 服务器名称: claude-playwright
  • 启动命令示例（供 MCP 客户端运行时使用的配置信息，不是客户端代码）
  • 具体配置项包含：
    • serverName: claude-playwright
    • command: node
    • args: ["dist/mcp/server.cjs"]
    • env: BASE_URL 设置为你的应用基础 URL，例如 http://localhost:3000
  • 说明：该配置用于 MCP 客户端在启动时连接到 MCP 服务器；客户端本身不需要此配置信息来工作，但用于建立初始连接与发现服务器能力。
  1. 基本使用方法
  • 在 Claude Code 中通过 /mcp 查看激活的 MCP 服务器，Claude 将通过已配置的 MCP 服务器进行资源访问、工具调用与对话上下文提供。
  • 你可以通过自然语言指令触发浏览器自动化、数据获取、表单处理等任务，服务器会协调执行并返回结果。
  • 可以通过 README/文档中的各类 CLI 命令与工具使用示例，逐步体验资源、工具、以及 Prompts 的协作能力。
  1. 额外信息
  • 服务器核心模块涵盖多种 MCP 相关能力：资源管理、工具注册与执行、Prompts 渲染、会话与缓存管理，以及可扩展的传输协议支持。
  • 项目还包含大量测试与示例，用于验证 MCP 服务器在不同场景下的行为与可靠性。
  1. 获取帮助
  • 如需了解具体 API、工具注册、Prompts 定义、以及如何扩展工具集，请参考仓库内的 README、各子模块文档以及示例代码。

服务器信息

访问项目