剧作家-mcp

Playwright 的 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 ：捕获页面或元素的视觉状态

Related MCP server: Playwright Server MCP

配置

安装依赖项

uv add playwright
playwright install chromium

快速入门

安装

克劳德桌面

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

"mcpServers": {
  "playwright-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/shannon/Workspace/artivus/playwright-mcp",
      "run",
      "playwright-mcp"
    ]
  }
}

"mcpServers": {
  "playwright-mcp": {
    "command": "uvx",
    "args": [
      "playwright-mcp"
    ]
  }
}

发展

构建和发布

准备分发包：

1. 同步依赖项并更新锁文件：

uv sync

2. 构建软件包分发版：

uv build

这将在dist/目录中创建源和轮子分布。

3. 发布到 PyPI：

uv publish

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

• 令牌： --token或UV_PUBLISH_TOKEN

• 或用户名/密码： --username / UV_PUBLISH_USERNAME和--password / UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，调试起来可能比较困难。为了获得最佳调试体验，我们强烈建议使用MCP Inspector 。

您可以使用以下命令通过npm启动 MCP Inspector：

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

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