使用说明

项目简介

Patchright Lite MCP 服务器是一个精简版的 Model Context Protocol (MCP) 服务器，它集成了 Patchright Node.js SDK，为AI模型提供强大的隐身浏览器自动化能力。它可以让AI模型通过标准协议控制浏览器，执行访问网页、填写表单、点击按钮等操作，同时避免被反机器人系统检测。

主要功能点

隐身自动化: 利用 Patchright 的反检测技术进行网页自动化操作，模拟用户行为而不易被网站识别。
核心工具集: 专注于提供浏览（打开网页、获取信息）、交互（点击、填写、选择）、提取（获取文本、HTML、截图）和关闭浏览器实例这4个基础但重要的自动化工具。
遵循MCP标准: 实现Model Context Protocol，方便与支持MCP协议的各种AI客户端（如某些AI助手、大模型开发平台）集成。
Stdio传输: 通过标准输入/输出来通信，易于在各种环境中部署和集成，无需复杂的网络配置。

安装步骤

确保你的系统已安装 Node.js 18+ 和 npm 或 yarn。
克隆该项目的代码仓库到本地目录。
进入项目目录。
运行 'npm install' 或 'yarn install' 安装项目依赖。
运行 'npm run build' 编译TypeScript源代码。

服务器配置

MCP客户端（如某些AI助手、大模型工具）需要知道如何启动这个MCP服务器。通常，这需要在客户端的配置文件中指定服务器的启动命令及其参数。以下是一个通用的配置示例结构：

{
  "mcpServers": {
    "patchright": {
      "command": "node",
      "args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
    }
  }
}

请将 '"path/to/patchright-lite-mcp-server"' 替换为你实际克隆和安装该服务器的目录路径。这个配置告诉MCP客户端使用 'node' 命令执行服务器的启动文件 'dist/index.js'，并将其注册为名为 "patchright" 的MCP服务器。具体的配置方式请参考你使用的MCP客户端的文档。

基本使用方法

在MCP客户端中完成服务器配置后，客户端启动时会自动启动 Patchright Lite MCP 服务器，并通过 StdIO 连接进行通信。AI模型即可通过调用该服务器提供的工具来执行浏览器自动化任务。

一个典型的使用流程是：

AI调用 'browse' 工具，指定要访问的 URL，启动一个浏览器实例并打开页面。服务器返回一个浏览器ID和页面ID。
AI利用上一步获取的浏览器ID和页面ID，调用 'interact' 工具，指定CSS选择器和动作（如 'click', 'fill', 'select'），在页面上执行交互操作。
AI可以再次调用 'extract' 工具，获取当前页面的文本、HTML内容或截图，以便理解页面状态或提取所需信息。
完成任务后，AI调用 'close' 工具，指定浏览器ID，关闭浏览器实例以释放资源。

通过组合这些工具，AI模型可以实现复杂的网页自动化工作流程。

关键词