Puppeteer Vision Mcp Server

@djannot

About Puppeteer Vision Mcp Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "web-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-vision-mcp-serve"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Puppeteer vision MCP Server?

This Model Context Protocol (MCP) server provides a tool for scraping webpages and converting them to markdown format using Puppeteer, Readability, and Turndown. It features AI-driven interaction capabilities to automatically handle cookies, captchas, and other interactive elements. It is intended for developers and LLM orchestrators that need structured web content.

How to use Puppeteer vision MCP Server?

Run the server directly via npx -y puppeteer-vision-mcp-server after setting required environment variables (e.g., OPENAI_API_KEY). It can also be configured as an MCP tool in an orchestrator using the JSON snippet provided in the README. Transport can be stdio (default), SSE, or HTTP, selected via the TRANSPORT_TYPE variable.

Key features of Puppeteer vision MCP Server

Scrapes webpages using Puppeteer with stealth mode
AI‑powered handling of cookies, CAPTCHAs, and overlays
Extracts main content with Mozilla's Readability
Converts HTML to well‑formatted Markdown with Turndown
Supports code blocks and tables with custom rules
Option to view browser interaction by disabling headless mode

Use cases of Puppeteer vision MCP Server

Scrape news articles that require dismissing cookie consent banners
Extract documentation or blog posts from pages with paywalls or login prompts
Capture structured content (code blocks, tables) from dynamic web pages
Feed cleaned Markdown into an LLM for further processing or summarization

FAQ from Puppeteer vision MCP Server

What AI model does it use?

It requires an OpenAI API key; the default vision model is gpt-4.1. You can change the model via the VISION_MODEL environment variable, and point to alternative providers by setting API_BASE_URL.

How do I see the browser during scraping?

Set the environment variable DISABLE_HEADLESS=true to run the browser in visible (non‑headless) mode.

What transport modes are supported?

Three modes are supported: stdio (default), sse, and http. Set the TRANSPORT_TYPE environment variable to switch between them.

Can I use a different AI provider?

Yes, set the API_BASE_URL environment variable to any OpenAI‑compatible

Frequently asked questions

What AI model does it use?

It requires an OpenAI API key; the default vision model is `gpt-4.1`. You can change the model via the `VISION_MODEL` environment variable, and point to alternative providers by setting `API_BASE_URL`.