MCP Web Snapshot

Name: MCP Web Snapshot
Author: gustavo-meilus

@gustavo-meilus

Repository

About MCP Web Snapshot

Take snapshot of websites and deliver it to LLM tools.

Basic information

Config

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

{
  "mcpServers": {
    "mcp-web-snapshot": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-web-snapshot",
        "run",
        "python",
        "src/server.py"
      ]
    }
  }
}

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 MCP Web Snapshot?

MCP Web Snapshot is a Model Context Protocol server that uses Playwright to capture comprehensive website snapshots, including accessibility trees, network requests, and console messages, designed for LLM-based analysis. It is built for developers using MCP clients such as VS Code, Cursor, Windsurf, or Claude Desktop.

How to use MCP Web Snapshot?

Install dependencies with uv sync and Playwright browsers with uv run playwright install, then configure the server in your MCP client using a JSON object with command: "uv" and args: ["--directory", "/path/to/mcp-web-snapshot", "run", "python", "src/server.py"]. After setup, invoke the website_snapshot tool with a valid URL.

Key features of MCP Web Snapshot

Fast and lightweight using Playwright’s accessibility tree
LLM-optimized structured data output
Comprehensive network and console message monitoring
Unique element references for interactive elements
Production-ready with error handling and timeouts
Well-tested with 92% code coverage

Use cases of MCP Web Snapshot

LLM-guided test generation from captured page structure
Web content analysis for pricing or feature comparison
Accessibility auditing based on WCAG guidelines
API integration analysis by monitoring network requests
Cross-browser test scenario creation from interactive elements

FAQ from MCP Web Snapshot

What are the system requirements?

Python 3.11 or newer and a compatible MCP client (e.g., VS Code, Cursor, Claude Desktop).

How do I install Playwright browsers?

Run uv run playwright install after setting up the project dependencies.

Can I customize the viewport size or timeout?

Yes, edit the CONFIG dictionary in src/tools/snapshot_url.py to adjust viewport, user agent, and timeout settings.

What happens if I provide an invalid URL?

The server returns a helpful error message for malformed URLs.

How is this different from the interactive Playwright MCP?

MCP Web Snapshot focuses on one-shot, structured snapshots with network and console monitoring, while Playwright MCP offers interactive browser control.