Browser Ctl

🚀 瀏覽器 CTL MCP 服務器

這是一個基於 SSE 和 Anthropic 的瀏覽器控制 MCP 服務器，藉助 Python Playwright 搭建而成。它提供了一系列實用工具，可助力 AI 代理實現對網絡瀏覽器的控制與交互。此簡易版本採用的是 Chrome 瀏覽器。

✨ 主要特性

已暴露工具

• 執行 JavaScript：可在即時瀏覽器中執行 JavaScript 代碼，藉助 Playwright 的評估方法，還能返回腳本結果。
• 訪問 URL：能訪問目標網址，並在即時瀏覽器中打開。
• 等待延遲：瀏覽器可隨機等待指定時長（在開始和結束時間之間）。
• 關閉瀏覽器：可關閉已打開的瀏覽器窗口。
• 打開瀏覽器：能在即時環境中啟動瀏覽器。
• 截取瀏覽器屏幕截圖：可捕獲當前瀏覽器頁面的截圖，並以 Base64 格式返回圖像數據。

📦 安裝指南

前期準備

首先，安裝 uv 並設置 Python 項目和環境：

• Linux 系統：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows 系統：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆倉庫

git clone https://github.com/biteval/browser_ctl.git

進入項目目錄

cd browser_ctl

創建虛擬環境並激活

uv init
uv venv

• Linux 系統：

source .venv/bin/activate

• Windows 系統：

.venv\Scripts\activate

安裝依賴項

• Linux 系統：

uv add "mcp[cli]" httpx playwright

• Windows 系統：

uv add mcp[cli] httpx playwright

下載 Playwright 瀏覽器二進制文件

python -m playwright install

啟動 Browser CTL MCP 服務器

python browser_ctl.py

📚 詳細文檔

默認日誌

此 MCP 服務器默認使用信息日誌級別啟動：

# 配置日誌記錄
logging.basicConfig(
    level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s"
)

默認端點

http://127.0.0.1:8001/sse

👏 貢獻說明

歡迎貢獻！您的專業知識和創意將為該項目帶來巨大影響。感謝您的參與！

📺 更多信息

訪問我們的 YouTube 頻道，瞭解如何創建 AI 代理：