Playwright MCP Server

产品定位

Playwright MCP Server 是一个浏览器自动化服务，旨在通过 MCP 协议提供对浏览器实例的全面控制，支持多页面管理、导航、内容检索、交互等多种功能。

核心功能

• 多页面管理：支持打开、关闭、切换和列出多个浏览器页面/标签。
• 导航功能：包括跳转到 URL、前进/后退、重新加载等。
• 内容检索：获取 HTML、文本内容、标题和当前 URL。
• 交互功能：点击、填充、键入、按键、勾选/取消勾选、选择选项、悬停、拖放等。
• 等待功能：等待元素、URL、加载状态等。
• 状态和信息：获取元素状态、属性、边界框等。
• 视觉功能：页面和元素的截图。
• JavaScript 执行：执行任意 JavaScript 代码（需谨慎使用）。

适用场景

• 自动化测试
• 网页数据抓取
• 网页内容交互模拟
• 多页面浏览器任务管理

工具列表

页面管理

导航

内容检索

交互

等待

状态和信息

视觉

JavaScript

常见问题解答

• 安全性问题：playwright_evaluate 和 playwright_execute_javascript 工具功能强大，但如果服务器公开暴露，可能会带来安全风险。建议谨慎使用或禁用这些功能。

使用教程

使用依赖

安装前置依赖：

pip install "fastmcp>=2.0.0" playwright

安装 Playwright 浏览器：

playwright install chromium

安装教程

运行服务器：

fastmcp run main.py --transport sse --port 8001

运行客户端脚本：

python client_example.py

调试方式

运行客户端脚本后，可以通过调用不同的工具来调试浏览器行为。例如：

import asyncio
from fastmcp import Client

async def main():
    async with Client("stdio://python main.py") as client:
        # Open a new page and navigate to a website
        page_info = await client.call_tool("playwright_open_page", {"url": "https://example.com"})

        # Get the page title
        title = await client.call_tool("playwright_get_title", {})
        print(f"Page title: {title}")

        # Click a button
        await client.call_tool("playwright_click", {"selector": "button.submit"})

        # Take a screenshot
        screenshot = await client.call_tool("playwright_take_screenshot", {"full_page": True})

if __name__ == "__main__":
    asyncio.run(main())

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。