使用说明

项目简介

twolven_mcp-server-puppeteer-py 是一个基于 Model Context Protocol (MCP) 的服务器，它使用 Python 和 Playwright 库来实现浏览器自动化功能。该服务器旨在为大型语言模型（LLM）提供与网页进行交互的能力，扩展 LLM 的应用场景，例如网页信息抓取、自动化测试、以及更丰富的用户界面交互等。

主要功能点

网页导航：允许 LLM 控制浏览器访问指定的 URL。
屏幕截图：支持截取整个网页或特定元素的屏幕截图，并返回给 LLM。
元素点击：模拟用户点击网页上的元素，例如按钮或链接。
表单填写：自动填写网页上的输入框。
JavaScript 执行：允许 LLM 在浏览器环境中执行 JavaScript 代码，获取网页动态信息或进行更复杂的操作。
详细的错误处理和日志记录：提供完善的错误信息和操作日志，方便调试和监控服务器运行状态。

安装步骤

环境准备：
- 确保已安装 Python 3.8 或更高版本。
- 确保已安装 pip（Python 包管理工具）。
安装依赖：打开终端，导航到仓库代码所在的目录，运行以下命令安装项目依赖：
```
pip install -r requirements.txt
```
安装 Playwright 浏览器：运行以下命令安装 Playwright 需要的浏览器驱动（Chromium, Firefox, WebKit）：
```
playwright install
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以下是一个示例 JSON 配置，您需要根据实际情况修改 'args' 中的路径：

{
  "mcpServers": {
    "puppeteer": {
      "command": "python",
      "args": ["path/to/puppeteer_server.py"]
    }
  }
}

配置参数说明：

'"puppeteer"': 服务器名称，您可以自定义，用于在客户端中引用此服务器。
'"command": "python"': 启动服务器的命令，这里使用 'python' 解释器。
'"args": ["path/to/puppeteer_server.py"]': 启动命令的参数，指向 'puppeteer_server.py' 脚本的路径。请将 'path/to/puppeteer_server.py' 替换为 'puppeteer_server.py' 文件在您本地文件系统中的实际路径。 例如，如果 'puppeteer_server.py' 文件位于 '/home/user/mcp-server-puppeteer-py/puppeteer_server.py'，则应配置为 '["/home/user/mcp-server-puppeteer-py/puppeteer_server.py"]'。

基本使用方法

启动服务器：在终端中，导航到仓库代码目录，运行以下命令启动 MCP 服务器：
```
python puppeteer_server.py
```
服务器成功启动后，将监听来自 MCP 客户端的请求。

客户端调用工具：在 MCP 客户端中，您可以使用预定义的工具来控制浏览器。例如，要让浏览器访问 'https://example.com'，您可以调用 'puppeteer_navigate' 工具并提供 URL 参数：

{
  "action": "call_tool",
  "tool_name": "puppeteer_navigate",
  "tool_arguments": {
    "url": "https://example.com"
  }
}

更多工具的使用方法和参数，请参考仓库 README.md 文件中 "Available Tools" 部分的说明。

注意：启动服务器后，请保持终端窗口运行，关闭终端窗口会停止服务器。

关键词