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

參數說明：

🔧 技術細節

該項目使用以下技術構建：

• FastMCP 實現 MCP 服務器。
• Playwright 進行瀏覽器自動化操作。
• playwright-extra 提供插件支持。
• puppeteer-extra-plugin-stealth 避免機器人檢測。

該項目使用 Bun，這是一個快速的一站式 JavaScript 運行時環境。