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检查器 使用此命令：

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

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