MCP Web Browser

🚀 MCP 網頁瀏覽器服務器

MCP 網頁瀏覽器服務器是一款功能強大的工具，它藉助 Playwright 實現無頭瀏覽器功能，支持多線程處理，具備擴展插件機制和安全隔離沙盒，能有效滿足網頁處理與自動化需求。

🚀 快速開始

安裝依賴

pip install mcp-web-browser[master]

初始化配置

from mcp_web_browser import BrowserManager

# 創建瀏覽器管理器實例
browser_manager = BrowserManager()

# 啟動默認瀏覽器實例
browser_manager.start_default_browser()

✨ 主要特性

• 無頭瀏覽器支持：通過 Playwright 提供強大的無頭瀏覽器功能，支持多種主流瀏覽器內核（如 Chromium、Firefox 和 WebKit）。
• 多線程處理：內置高效的多線程架構，能夠同時處理多個網頁請求和任務。
• 擴展插件機制：支持靈活的擴展插件系統，用戶可以根據需求自定義功能模塊。
• 安全隔離沙盒：每個瀏覽器實例運行在獨立的沙盒環境中，確保相互之間不會受到干擾，有效防止惡意腳本攻擊。

💻 使用示例

基礎用法

# 創建一個新的 Chromium 瀏覽器實例
new_browser = browser_manager.create_browser_instance(engine='chromium')

# 訪問指定 URL
new_browser.goto('https://www.example.com')

高級用法

# 查找並點擊登錄按鈕
login_button = new_browser.find_element(by=By.CSS_SELECTOR, value='#login-btn')
login_button.click()

# 填寫表單信息
username_input = new_browser.find_element(by=By.ID, value='username')
password_input = new_browser.find_element(by=By.ID, value='password')
username_input.send_keys('your_username')
password_input.send_keys('your_password')

🔧 技術細節

安全特性

• 請求過濾：支持基於規則的 URL 過濾，防止訪問惡意網站。
• 腳本沙盒：所有用戶提供的腳本都在隔離環境中執行，確保核心系統安全。
• 資源限制：每個瀏覽器實例都有獨立的資源配額，防止資源濫用。

故障排除

問題排查步驟

1. 檢查瀏覽器日誌，獲取詳細錯誤信息。
2. 確保所有依賴項已正確安裝並處於最新版本。
3. 查看系統防火牆和安全軟件是否阻止了必要的端口。

常見問題解答

• 問題：無法啟動瀏覽器實例。
  • 解決方法：檢查是否有足夠的權限，確保相關服務進程沒有被殺掉。

擴展開發

創建插件

1. 創建一個新的 Python 包。
2. 在包中實現 IBrowserPlugin 接口。
3. 將插件註冊到瀏覽器管理器。

示例插件代碼

from mcp_web_browser.plugins import IBrowserPlugin

class MyCustomPlugin(IBrowserPlugin):
    def on_before_navigate(self, browser, url):
        print(f"即將訪問: {url}")

    def on_after_navigate(self, browser, url):
        print(f"已訪問: {url}")

貢獻指南

開發環境搭建

git clone https://github.com/yourusername/mcp-web-browser.git
cd mcp-web-browser
pip install -r requirements.txt

提交代碼規範

1. 為每個功能分支創建獨立的開發分支。
2. 在提交前確保通過所有單元測試和集成測試。
3. 提供詳細的變更日誌，說明修改的內容和原因。

📄 許可證

本項目遵循 MIT 許可證。更多詳細信息請參考 LICENSE 文件。

🔗 相關鏈接

• MCP 協議官網
• Playwright 官網
• Claude 桌面版

🆘 支持與幫助

如遇到問題，請通過以下方式尋求支持：

• 提交 GitHub 問題：GitHub Issues