Playwright Universal MCP

一個基於Playwright的通用MCP服務器，為AI助手提供多瀏覽器自動化控制能力，支持容器化部署和多種操作模式。

瀏覽器自動化開發者工具 #瀏覽器自動化 #容器友好 #多瀏覽器支持 #AI助手工具 .Python

評分 : 2分

下載量 : 7

更新時間 : 2025-04-28

什麼是Playwright Universal MCP?

Playwright Universal MCP是一個基於Model Context Protocol(MCP)的瀏覽器自動化服務器，它允許AI助手(如Claude、GPT-4等)通過標準協議控制瀏覽器完成網頁操作。

如何使用Playwright Universal MCP?

安裝後只需運行簡單的啟動命令，配置AI助手連接即可開始使用。支持多種瀏覽器和運行模式選擇。

適用場景

適用於需要瀏覽器自動化的AI應用場景，如網頁數據採集、自動化測試、網頁內容分析等，特別適合在容器化環境中部署使用。

主要功能

多瀏覽器支持支持Chromium、Chrome、Microsoft Edge、Firefox和WebKit等多種瀏覽器引擎

容器友好專為容器化環境優化，可在Docker等受限權限環境中穩定運行

無頭/有頭模式支持無頭模式(服務器環境)和有頭模式(調試用)

全面的瀏覽器控制提供導航、點擊、輸入、截圖等多種瀏覽器操作功能

多頁面支持可同時創建和管理多個瀏覽器頁面/標籤頁

優勢與侷限性

優勢

支持多種主流瀏覽器，兼容性好

專為容器化環境設計，部署簡單

提供豐富的瀏覽器操作API

與AI助手無縫集成

侷限性

需要預先安裝瀏覽器引擎

在資源受限的環境中性能可能受影響

部分高級瀏覽器功能可能需要額外配置

如何使用

安裝

選擇以下任一方式安裝Playwright Universal MCP

啟動服務

使用命令行啟動MCP服務器

配置AI助手

在AI助手配置文件中添加MCP服務器連接信息

開始使用

通過AI助手發送指令控制瀏覽器

使用案例

網頁數據採集自動導航到目標網頁並提取特定數據

自動化測試模擬用戶操作進行網頁功能測試

網頁截圖對指定網頁進行截圖保存

常見問題

為什麼需要安裝瀏覽器?

如何在Docker中使用?

支持哪些AI助手?

如何查看運行日誌?

🚀 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"]