JinDaGe - playwright-universal-mcp MCP Details

article

README

🚀 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 实现

playwright-universal-mcp