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) 提供技術支持

⚠️ 重要提示

請遵守相關法律法規，責任自負，避免濫用技術進行非法活動。

💡 使用建議

不要過度自動化，以免影響網站服務。