Playwright Universal MCP

🚀 Playwright Universal MCP 中文版

Playwright Universal MCP 是一個通用的模型上下文協議（MCP）服務器，專為瀏覽器自動化而設計。它能夠在容器化環境的受限權限下可靠運行，為 Claude、GPT - 4 等 AI 助手提供強大的瀏覽器控制功能。

🚀 快速開始

Playwright Universal MCP 為瀏覽器自動化提供了便捷的解決方案，可在多種環境下運行。下面將詳細介紹其安裝和使用方法。

✨ 主要特性

• 🌐 多瀏覽器支持：支持 Chromium、Chrome、Microsoft Edge、Firefox 或 WebKit 等多種瀏覽器，滿足不同場景需求。
• 🐳 容器友好：非常適合在 Docker 等受限環境中使用，方便部署和管理。
• 👁️ 無頭/有頭模式：在服務端可使用無頭模式，調試時可切換為有頭模式，靈活滿足不同階段的使用需求。
• 🛠️ 全面瀏覽器控制：具備導航、點擊、輸入、截圖等豐富功能，實現對瀏覽器的全方位控制。
• 📄 多頁面支持：可以輕鬆創建和管理多個瀏覽器標籤頁，提高工作效率。

📦 安裝指南

選項 1：通過 pipx 安裝（推薦）

# 全局安裝 MCP 服務器
pipx install playwright-universal-mcp

# 安裝所需瀏覽器
playwright install chromium
# 可選：安裝其他瀏覽器
playwright install firefox webkit msedge chrome

選項 2：虛擬環境安裝

# 創建並激活虛擬環境
python -m venv playwright-mcp-venv
source playwright-mcp-venv/bin/activate

# 安裝包
pip install playwright-universal-mcp

# 安裝瀏覽器
playwright install chromium

選項 3：從源碼安裝

# 克隆倉庫
git clone https://github.com/yourusername/playwright-universal-mcp.git
cd playwright-universal-mcp

# 安裝包
pip install -e .

# 安裝瀏覽器
playwright install chromium

💻 使用示例

命令行選項

playwright-universal-mcp --help

顯示幫助信息：

使用方法：playwright-universal-mcp [選項]
常用選項：
  --version   顯示版本號並退出
  -h, --help  顯示此幫助信息並退出

📚 詳細文檔

MCP 配置

Claude Desktop 配置

在 Claude 的settings.json中添加以下內容，指定 MCP 服務器地址：

{
  "mcp": {
    "serverUrl": "http://localhost:1234"
  }
}

其他應用配置

根據具體應用的文檔進行相應設置。

容器化使用

# 使用基礎鏡像
FROM python:3.8

# 安裝依賴項
RUN pip install playwright-universal-mcp

# 安裝所需瀏覽器
RUN playwright install chromium

# 啟動服務器
ENTRYPOINT ["playwright-universal-mcp", "--headless"]

瀏覽器工具集

MCP 服務器提供以下功能：

• navigate：導航至指定 URL
• click：通過選擇器或文本點擊元素
• type：向輸入框中輸入文字
• get_text：獲取元素的文本內容
• get_page_content：獲取當前頁面 HTML 內容
• take_screenshot：截取當前頁面屏幕
• new_page：創建新瀏覽器標籤頁
• switch_page：切換至指定標籤頁
• get_pages：列出所有可用標籤頁
• wait_for_selector：等待元素出現並可見
• get_browser_info：獲取瀏覽器會話信息

📄 許可證

MIT License

致謝

本項目基於以下優秀項目：

• Playwright 提供的瀏覽器自動化功能
• 模型上下文協議（MCP） 的連接標準
• MCP Python SDK 提供的 MCP 實現