关键词

浏览器自动化Playwright控制台日志网络监控网页交互LLM工具

使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，它使用 Playwright 库来控制浏览器，并提供一系列工具，使 LLM 客户端能够与网页进行交互，并获取网页的控制台日志和网络请求信息。这使得 LLM 能够理解网页的动态行为，并基于这些信息进行更智能的决策。

主要功能点

  • 打开指定URL的浏览器页面：支持打开新的浏览器页面，并导航到指定的 URL。
  • 监控和获取控制台日志：实时捕获并存储浏览器控制台输出的日志信息，包括各种类型的消息，并支持按需获取最新的日志。
  • 跟踪和获取网络请求：记录浏览器发出的网络请求和响应，包括请求的 URL、方法、Header 以及响应状态等详细信息。
  • 关闭浏览器：提供关闭当前打开的浏览器实例的功能，清理资源。

安装步骤

  1. 安装 Python 3.8+: 确保您的系统已安装 Python 3.8 或更高版本。
  2. 安装 Python 包: 使用 pip 安装必要的 Python 包： 
    pip install playwright modelcontextprotocol
  3. 安装 Playwright 浏览器: 运行 Playwright 安装命令以下载浏览器驱动： 
    playwright install

服务器配置

对于 MCP 客户端，您需要配置连接到此 MCP 服务器的信息。以下是一个 JSON 格式的配置示例，您需要将其添加到 MCP 客户端的配置文件中（例如 Claude 客户端的 'claude_desktop_config.json'）：

{
  "serverName": "playwright-browser",
  "command": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/DIRECTORY/.local/bin/uv",
  "args": [
    "--directory",
    "/ABSOLUTE/PATH/TO/YOUR/PROJECT/DIRECTORY/",
    "run",
    "mcp_playwright/main.py"
  ]
}

配置参数说明:

  • 'serverName': 服务器名称，客户端用此名称来标识和调用此服务器，例如 "playwright-browser"。
  • 'command': 启动服务器的命令。这里假设您使用 'uv' 虚拟环境运行，并且 'uv' 可执行文件位于项目目录的 '.local/bin' 下。请根据您的实际 Python 环境配置进行调整，如果直接使用 'python3' 或 'python' 命令，请修改为您的 Python 解释器路径。
  • 'args': 启动命令的参数列表。
    • '--directory': 指定项目根目录的绝对路径。请将 '/ABSOLUTE/PATH/TO/YOUR/PROJECT/DIRECTORY/' 替换为您的项目实际存放的绝对路径。
    • 'run': 使用 'uv run' 运行 Python 脚本。
    • 'mcp_playwright/main.py': 指定要运行的 MCP 服务器主程序脚本的相对路径。

注意: 请务必将配置中的 '/ABSOLUTE/PATH/TO/YOUR/PROJECT/DIRECTORY/' 替换为您克隆的仓库在您本地文件系统中的绝对路径。'command' 和 'args' 需要根据您的 Python 环境和脚本路径进行调整。

基本使用方法

  1. 确保 MCP 服务器已成功配置并在运行。
  2. 在 MCP 客户端中，您可以使用配置的 'serverName' ("playwright-browser") 来调用此服务器提供的工具。
  3. 可用的工具包括：
    • 'open_browser(url: str, headless: bool = False)': 打开指定 URL 的浏览器页面。
    • 'get_console_logs(last_n: int)': 获取最新的 'last_n' 条控制台日志。
    • 'get_network_requests(last_n: int)': 获取最新的 'last_n' 条网络请求信息。
    • 'close_browser()': 关闭浏览器。

具体工具的调用方式和参数传递，请参考您的 MCP 客户端的使用文档。

信息

分类

开发者工具

访问项目