Patchright Stealth Browser

🚀 Patchright 轻量级 MCP 服务器

Patchright 是一个精简的模型上下文协议（MCP）服务器，它封装了 Patchright Node.js SDK，能为 AI 模型赋予浏览器自动化能力。该项目聚焦于实现浏览器自动化任务，同时巧妙避免被目标网站检测。

🚀 快速开始

先决条件

• Node.js 版本 >= 14.0.0
• npm 或 Yarn 包管理工具

安装步骤

# 克隆仓库到本地
git clone https://github.com/your-repository.git
cd patchright-mcp

# 安装依赖项
npm install

# 构建项目
npm run build

运行服务器

# 启动 MCP 服务器
npm start

✨ 主要特性

• 简单界面：提供易用的 API，可快速实现浏览器自动化。
• 隐身自动化：能有效规避目标网站的反爬虫机制。
• 模型上下文协议 (MCP)：支持与 AI 模型交互的标准接口。
• 标准输入输出 (Stdio) 传输：简化了数据交互流程。

📦 安装指南

克隆与安装

# 克隆仓库到本地
git clone https://github.com/your-repository.git
cd patchright-mcp

# 安装依赖项
npm install

# 构建项目
npm run build

启动服务器

# 启动 MCP 服务器
npm start

💻 使用示例

基础用法

// 启动浏览器并访问页面
await page.load('https://example.com');

// 模拟用户输入
await page.type('#searchInput', 'test');
await page.click('#submitBtn');

高级用法

// 避免检测的属性设置
document.addEventListener('DOMContentLoaded', function() {
  console.log(window);
});

完整使用流程

1. 启动浏览器并访问目标页面
2. 模拟用户输入和交互
3. 提取验证信息
4. 关闭浏览器

📚 详细文档

Claude Desktop 配置

在 config.json 中添加以下内容：

{
  "mcp": {
    "serverUrl": "http://localhost:3000"
  }
}

VS Code with GitHub Copilot 设置

安装 Model Context Protocol 插件，配置如下：

{
  "modelContextProtocol": {
    "servers": [
      {
        "url": "http://localhost:3000",
        "label": "Patchright MCP Server"
      }
    ]
  }
}

Docker 使用说明

快速运行

docker run -it --rm dylangroos/patchright-mcp

构建镜像

docker build -t patchright-mcp .

启动容器

docker run -it --rm patchright-mcp

Docker Hub 镜像

最新版本已自动发布至 Docker Hub，访问地址：dylangroos/patchright-mcp

🔧 技术细节

Patchright 是 Playwright 的未被检测到版本，专为规避检测设计。它通过修复多种检测技术（如 Runtime.enable 泄漏、Console.log 满足等）实现隐身效果。

📄 许可证

本项目采用 MIT 许可证，具体内容见 LICENSE 文件。

致谢

感谢以下项目的贡献：

• Patchright-nodejs 由 Kaliiiiiiiiii-Vinyzu 开发
• 模型上下文协议 (MCP) 提供技术支持

⚠️ 重要提示

请遵守相关法律法规，责任自负，避免滥用技术进行非法活动。

💡 使用建议

不要过度自动化，以免影响网站服务。