AI导哈

浏览器自动化工具

Playwright-MCP是一个基于Model Context Protocol的浏览器自动化工具，使LLM驱动的客户端能够控制浏览器执行自动化任务。

  • by artivus-labs
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 misanthropic-ai/playwrite-mcp

使用说明

剧作家mcp

MCP（模型上下文协议）的剧作家包装器。此服务器使LLM驱动的客户端能够控制浏览器以执行自动化任务。

组件

资源

服务器公开用于访问浏览器屏幕截图的资源：

  • 屏幕截图资源URI: screenshot://{page_id}
  • 屏幕截图资源可自动用于所有打开的页面

鼓励

服务器提供提示以帮助客户端解释网页：

  • interpret-page：分析当前网页的内容和结构
    • 可选的 page_id 用于选择要解释的页面的参数
    • 可选的 focus 专注于特定方面的论点（全文、形式、导航、文本）
    • 返回文本分析和页面截图

工具

服务器实现了一套全面的浏览器自动化工具：

  • 浏览器导航

    • navigate：转到特定URL
    • new_page：使用特定ID创建新的浏览器页面
    • switch_page：切换到其他浏览器页面
    • get_pages：列出所有可用的浏览器页面

  • 页面交互

    • click：使用CSS选择器单击元素
    • type：在输入元素中键入文本
    • wait_for_selector：等待页面上出现元素

  • 内容提取

    • get_text：从元素中获取文本内容
    • get_page_content：获取整个页面的HTML
    • take_screenshot：捕获页面或元素的视觉状态

配置

再进行

uv add playwright
playwright install chromium

快速启动

安装

克劳德桌面

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
在Windows上： %APPDATA%/Claude/claude_desktop_config.json

Development/Unpublished Servers Configuration 
"mcpServers": {
  "playwright-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/shannon/Workspace/artivus/playwright-mcp",
      "run",
      "playwright-mcp"
    ]
  }
}
Published Servers Configuration 
"mcpServers": {
  "playwright-mcp": {
    "command": "uvx",
    "args": [
      "playwright-mcp"
    ]
  }
}

发展

建筑与出版

准备分发包裹：

  1. 同步依赖关系并更新锁文件：
uv sync
  1. 构建包分发：
uv build

这将在 dist/ 目录。

  1. 发布到PyPI：
uv publish

注意：您需要通过环境变量或命令标志设置PyPI凭据：

  • 令牌： --token 或 UV_PUBLISH_TOKEN
  • 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 npm 使用此命令：

npx @modelcontextprotocol/inspector uv --directory /Users/shannon/Workspace/artivus/playwright-mcp run playwright-mcp

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

相关 MCP