stealth-browser-mcp

🚀 隐身浏览器 MCP 服务器

隐身浏览器 MCP 服务器借助 Playwright 和反检测技术，实现隐身浏览器功能。它基于 MCP (模型上下文协议)，能让 MCP 客户端在访问网站并截取截图时，有效避开常见的机器人检测系统。

🚀 快速开始

隐身浏览器 MCP 服务器使用便捷，按以下步骤即可快速开启服务：

# 安装依赖项
bun install

# 运行 MCP 服务器
bun start

✨ 主要特性

• 隐身模式：借助 puppeteer-extra-plugin-stealth 与 playwright-extra，对浏览器指纹进行修改，使流量伪装成普通用户流量，从而巧妙避开机器人检测。它还能对 WebGL、Canvas、字体、插件和其他浏览器指纹技术进行处理。
• 截图工具：可对任何网站进行全页截图，也能针对特定元素进行截图。支持无头模式（默认）和可见浏览器模式。
• MCP 集成：通过模型上下文协议提供浏览器功能。

📦 安装指南

# 安装依赖项
bun install

💻 使用示例

基础用法

# 运行 MCP 服务器
bun start

# 开发模式
bun dev

# 检查可用工具
bun inspect

高级用法

使用 screenshot 工具截取网页截图：

# 示例命令，可根据需求调整参数
bun screenshot --url="https://example.com" --fullPage=true --selector=".example-class" --headless=false

参数说明： | 参数 | 详情 | |------|------| | url | 字符串类型，必需参数，要访问的 URL 地址 | | fullPage | 布尔值类型，可选参数，默认为 true，表示是否捕获整个页面 | | selector | 字符串类型，可选参数，CSS 选择器，仅截取特定元素 | | headless | 布尔值类型，可选参数，默认为 true，表示是否以无头模式运行或显示浏览器界面 |

🔧 技术细节

该项目使用以下技术构建：

• FastMCP 实现 MCP 服务器。
• Playwright 进行浏览器自动化操作。
• playwright-extra 提供插件支持。
• puppeteer-extra-plugin-stealth 避免机器人检测。

该项目使用 Bun，这是一个快速的一站式 JavaScript 运行时环境。