mcp-playwright

一个基于 FastMCP 框架的专业级 Playwright 浏览器自动化 MCP 服务器，为 LLM 应用提供强大的网页交互和数据提取能力。

• 浏览器自动化: 完整的 Playwright 浏览器控制能力
• 多引擎支持: 支持 Chromium、Firefox、WebKit
• 会话管理: 独立的浏览器会话，支持并发操作
• 资源管理: 智能的生命周期管理和资源清理
• 错误恢复: 完善的错误处理和超时控制

• 模块化设计: 清晰的代码架构和职责分离
• 类型安全: 完整的 TypeScript 风格类型注解
• 异步安全: 基于 asyncio 的并发安全实现
• 生命周期管理: 使用 FastMCP 的生命周期机制
• 日志系统: 结构化的日志记录和监控

• 浏览器控制: 创建/关闭会话、页面导航
• 页面交互: 点击、输入、等待元素
• 数据提取: 文本内容、属性值、页面信息
• 高级功能: 截图、JavaScript 执行
• 资源接口: 会话状态、健康检查

# 从 PyPI 安装（推荐）
pip install mcp-playwright

# 或使用 uv
uv add mcp-playwright

# 安装 Playwright 浏览器
playwright install

# 开发安装（从源码）
git clone https://github.com/ma-pony/mcp-playwright.git
cd mcp-playwright

# 使用 uv 安装依赖（推荐）
uv sync

# 或使用 pip
pip install -e .

# 安装 Playwright 浏览器
uv run playwright install
# 或
playwright install

# 使用已安装的包
mcp-playwright

# 或从源码运行
python main.py

# 或使用 uv
uv run python main.py

# 使用 MCP 开发工具
uv run mcp dev main.py

将以下配置添加到 Claude Desktop 的 MCP 配置文件中：

{
  "mcpServers": {
    "playwright": {
      "command": "mcp-playwright"
    }
  }
}

或者如果从源码运行：

{
  "mcpServers": {
    "playwright": {
      "command": "uv",
      "args": ["run", "python", "/path/to/mcp-playwright/main.py"],
      "env": {}
    }
  }
}

1. 创建浏览器会话

# 使用 create_browser_session 工具
await create_browser_session(
    browser_type="chromium",
    headless=True,
    viewport_width=1280,
    viewport_height=720
)

1. 导航到目标网站

await navigate_to_url("https://example.com")

1. 页面交互