🚀 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);
});
完整使用流程
- 启动浏览器并访问目标页面
- 模拟用户输入和交互
- 提取验证信息
- 关闭浏览器
📚 详细文档
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) 提供技术支持
⚠️ 重要提示
请遵守相关法律法规，责任自负，避免滥用技术进行非法活动。
💡 使用建议
不要过度自动化，以免影响网站服务。