webshot-mcp

中文文档 | English

A MCP (Model Context Protocol) server for generating web page screenshots, implemented with Playwright.

Features

🌐 Support for any web page screenshots
📱 Support for multiple device types (desktop, mobile, tablet)
🎨 Support for multiple image formats (PNG, JPEG, WebP)
📏 Support for custom dimensions and DPI scaling
🖼️ Support for full-page screenshots
🗜️ Support for image quality compression
⚡ Asynchronous processing for excellent performance

Usage

As MCP Server

Method 1: Run directly with uvx (Recommended)

{ "mcpServers": { "webshot": { "command": "uvx", "args": ["webshot-mcp"] } } }

Method 2: Use with Claude Code

Claude Code can be configured to use this MCP server in two ways:

Option A: Using the CLI wizard

claude mcp add

Then follow the prompts to add webshot-mcp.

Option B: Direct config file editing (Recommended)

Edit your Claude Code configuration file (~/.claude.json) and add:

{ "mcpServers": { "webshot": { "type": "stdio", "command": "uvx", "args": ["webshot-mcp"] } } }

After editing the config file, restart Claude Code to apply the changes.

Method 3: Install with pip and run

# Install webshot-mcp pip install webshot-mcp # Install chromium browser playwright install chromium

Then add to your MCP client configuration:

For Claude Desktop (

{ "mcpServers": { "webshot": { "command": "webshot-mcp" } } }

For Claude Code (

{ "mcpServers": { "webshot": { "type": "stdio", "command": "webshot-mcp" } } }

Tool Parameters

The webshot tool supports the following parameters:

Required Parameters

url (string): URL of the web page to screenshot
output (string): Path to save the screenshot file

Optional Parameters

width (integer): Browser window width, default 1280
height (integer): Browser window height, default 768. Set to 0 for full-page screenshot
dpi_scale (number): DPI scaling ratio, default 2
device (string): Device type, options:
- desktop (default): Desktop device
- mobile: Mobile device (iPhone 13)
- tablet: Tablet device (iPad Pro)
format (string): Image format, options:
- png (default): PNG format
- jpeg: JPEG format
- webp: WebP format
quality (integer): Image quality (0-100), default 100. Only effective for JPEG and WebP formats

Usage Examples

Basic Screenshot

{ "name": "webshot", "arguments": { "url": "https://example.com", "output": "/tmp/screenshot.png" } }

Full-page Screenshot

{ "name": "webshot", "arguments": { "url": "https://example.com", "output": "/tmp/fullpage.png", "height": 0 } }

Mobile Device Screenshot

{ "name": "webshot", "arguments": { "url": "https://example.com", "output": "/tmp/mobile.png", "device": "mobile" } }

High-quality JPEG Screenshot

{ "name": "webshot", "arguments": { "url": "https://example.com", "output": "/tmp/screenshot.jpg", "format": "jpeg", "quality": 90 } }

Custom Size Screenshot

{ "name": "webshot", "arguments": { "url": "https://example.com", "output": "/tmp/custom.png", "width": 1920, "height": 1080, "dpi_scale": 1 } }

Development

Run Tests

uv run pytest

Code Structure

webshot-mcp/ ├── src/webshot_mcp/ │ ├── __init__.py │ ├── cli.py # CLI entry point │ └── server.py # MCP server implementation ├── tests/ │ └── test_server.py # Test cases ├── pyproject.toml # Project configuration └── README.md

Tech Stack

MCP: Model Context Protocol framework
Playwright: Browser automation and screenshots
Pillow: Image processing and compression
asyncio: Asynchronous programming support

Publishing

Build and Publish to PyPI

# Install build tools uv add --dev build twine # Build package uv run python -m build # Publish to PyPI uv run twine upload dist/*

License

MIT License

Contributing

Issues and Pull Requests are welcome!

Changelog

v0.1.0

Initial release
Support for basic web page screenshot functionality
Support for multiple device types and image formats
Support for image quality compression and size adjustment

Deploy Server

HTTP connection URL

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

webshot

Enables taking screenshots of web pages with support for multiple devices (desktop, mobile, tablet), custom dimensions, full-page capture, and various image formats. Built with Playwright for reliable web page rendering and screenshot generation.

Webshot MCP