🚀 木偶师服务器

木偶师服务器是一个基于Puppeteer的模型上下文协议（MCP）服务器，它能够提供强大的浏览器自动化功能。借助该服务器，大语言模型（LLMs）可以与网页进行交互、截取屏幕截图，还能在真实的浏览器环境中执行JavaScript代码。

🚀 快速开始

本部分将为你介绍木偶师服务器的核心功能、使用配置、构建方法等内容，助你快速上手。

✨ 主要特性

• 浏览器自动化：实现浏览器的自动化操作，提高工作效率。
• 控制台日志监控：实时监控浏览器控制台输出的文本信息。
• 屏幕截图功能：支持截取网页或特定元素的屏幕截图。
• JavaScript执行能力：可在浏览器控制台执行JavaScript代码。
• 基本网页交互：提供导航、点击、表单填写等基本网页交互功能。

📦 安装指南

Docker

注意：Docker实现使用无头Chromium，而NPX版本会打开浏览器窗口。

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"]
    }
  }
}

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

构建

Docker构建：

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

💻 使用示例

工具

资源

服务器提供以下两种资源：

1. 控制台日志 (console://logs)
   • 浏览器控制台输出的文本信息
   • 包含所有来自浏览器的控制台消息
2. 屏幕截图 (screenshot://<name>)
   • PNG格式的截屏图像
   • 可通过捕获时指定的截图名称访问

📚 详细文档

核心功能

• 浏览器自动化：通过各种工具实现浏览器的自动化操作。
• 控制台日志监控：可通过访问console://logs获取浏览器控制台输出的文本信息。
• 屏幕截图功能：使用puppeteer_screenshot工具截取屏幕截图，并通过screenshot://<name>访问。
• JavaScript执行能力：使用puppeteer_evaluate工具在浏览器控制台执行JavaScript代码。
• 基本网页交互：提供导航、点击、表单填写等基本网页交互功能，可通过相应工具实现。

📄 许可证

该MCP服务器根据MIT License授权。这意味着您可以在不受限制的情况下使用、修改和分发软件，但需遵守MIT License的条款和条件。如需更多信息，请参阅项目仓库中的LICENSE文件。