mcp-scrape-copilot

The Puppeteer Model Context Protocol (MCP) server is designed to facilitate browser automation by leveraging Puppeteer, a Node library that provides a high-level API to control headless Chrome or Chromium. This server allows Language Model Models (LLMs) to perform various web interactions such as navigating to URLs, taking screenshots, clicking elements, and executing JavaScript in a real browser environment. It is particularly useful for tasks that require web scraping, automated testing, or any scenario where interaction with a web page is necessary. The server supports both headless and non-headless modes, providing flexibility depending on the use case. Additionally, it offers resources like console logs and screenshots, which can be accessed and utilized for further analysis or reporting.

Features

• Browser automation
• Console log monitoring
• Screenshot capabilities
• JavaScript execution
• Basic web interaction (navigation, clicking, form filling)

MCP Tools

• {'puppeteer_navigate': 'Navigate to any URL in the browser'}
• {'puppeteer_screenshot': 'Capture screenshots of the entire page or specific elements'}
• {'puppeteer_click': 'Click elements on the page'}
• {'puppeteer_hover': 'Hover elements on the page'}
• {'puppeteer_fill': 'Fill out input fields'}
• {'puppeteer_select': 'Select an element with SELECT tag'}
• {'puppeteer_evaluate': 'Execute JavaScript in the browser console'}

MCP Resources

• {'Console Logs': 'Browser console output in text format'}
• {'Screenshots': 'PNG images of captured screenshots'}

Usage with Different Platforms

Docker

{
  "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 Build

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