Website Snapshot

by gustavo-meilus

6 stars
161 downloads
Not rated
GitHub

About

A MCP server that provides comprehensive website snapshot capabilities using Playwright. This server enables LLMs to capture and analyze web pages through structured accessibility snapshots, network monitoring, and console message collection.

Details

Author
gustavo-meilus
GitHub stars
6
Downloads
161
Categories
Web Scraping, Community, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Website Snapshot
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

MCP Web Snapshot

A Model Context Protocol (MCP) server that provides comprehensive website snapshot capabilities using Playwright. This server enables LLMs to capture and analyze web pages through structured accessibility snapshots, network monitoring, and console message collection.

Key Features

- 🚀 Fast and lightweight: Uses Playwright's accessibility tree for efficient snapshots
- 🎯 LLM-optimized: Structured data output designed specifically for AI consumption
- 📊 Comprehensive monitoring: Captures network requests, responses, and console messages
- 🔍 Element references: Adds unique identifiers to interactive elements for precise targeting
- 🛡️ Production-ready: Built-in error handling, resource limits, and timeout management
- ✅ Well-tested: Comprehensive test suite with code coverage

Requirements

- Python 3.11 or newer
- VS Code, Cursor, Windsurf, Claude Desktop or any other MCP client

Getting Started

First, install the MCP Web Snapshot server with your client. A typical configuration looks like this:

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

Install in VS Code

You can install the MCP Web Snapshot server using the VS Code CLI:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.