使用说明

项目简介

MCP Playwright CDP 是一个基于 Model Context Protocol (MCP) 构建的服务器，它利用 Playwright 浏览器自动化库和 Chrome DevTools Protocol (CDP) 技术，为大型语言模型 (LLM) 提供操作浏览器和执行 HTTP 请求的能力。该服务器旨在扩展 LLM 的应用场景，使其能够与网页内容和 Web API 进行交互，从而实现更丰富的功能。

主要功能点

网页自动化: 允许 LLM 通过工具控制真实的浏览器，执行如导航、点击、填写表单、截图、执行 JavaScript 等操作，实现网页内容抓取和交互。
CDP 连接: 支持连接到已运行的 Chrome 浏览器实例，提高效率并方便调试。
API 交互: 提供 HTTP GET、POST、PUT、PATCH、DELETE 等请求工具，使 LLM 能够与 Web API 进行数据交互和测试。
资源管理: 将浏览器控制台日志和屏幕截图作为资源提供给 LLM 客户端访问。
MCP 协议兼容: 遵循 Model Context Protocol 标准，确保与各种 MCP 客户端的兼容性。

安装步骤

手动安装 (npm): 打开终端，克隆仓库到本地，并进入仓库目录：

git clone https://github.com/lars-hagen/mcp-playwright-cdp.git
cd mcp-playwright-cdp
npm install

服务器配置

要将 MCP Playwright CDP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要提供服务器的启动命令和参数。以下是一个配置示例，请根据您的实际安装路径进行调整。

{
  "mcpServers": {
    "playwright-cdp": {
      "command": "node",
      "args": ["/path/to/mcp-playwright-cdp/dist/index.js"]
      // 请将 "/path/to/mcp-playwright-cdp" 替换为 MCP Playwright CDP 服务器在您本地文件系统中的实际路径。
      // 例如: "/Users/yourusername/Documents/mcp-playwright-cdp/dist/index.js"
    }
  }
}

基本使用方法

确保已安装 Node.js 环境。
按照安装步骤安装 MCP Playwright CDP 服务器。
在 MCP 客户端的配置文件中添加上述服务器配置，并根据实际情况修改路径。
启动 MCP 客户端。客户端将连接到 MCP Playwright CDP 服务器，并将服务器提供的工具暴露给 LLM 使用。
在 LLM 的提示词中，您可以调用服务器提供的工具来执行浏览器自动化或 API 请求等任务。例如，使用 'playwright_navigate' 工具可以指示浏览器访问特定网页，使用 'playwright_screenshot' 工具可以截取网页屏幕截图。

注意：首次使用 CDP 连接功能时，您可能需要先启动 Chrome 浏览器并启用远程调试功能。启动 Chrome 时需要添加 '--remote-debugging-port=9222' 参数。

关键词

使用说明

信息