mcp-screenshot-server

MCP.Pizza Chef: sethbang

The mcp-screenshot-server is an MCP server that enables automated screenshot capture of web pages and local HTML files via a simple MCP tool interface. Built on Puppeteer, it supports configurable viewport sizes, full-page screenshots, and custom output paths. It manages screenshot directories automatically, making it ideal for integration into AI workflows requiring visual context or documentation. Installation is straightforward with npm, and it offers a flexible API for specifying URLs, viewport dimensions, and output options.

Use This MCP server To

Capture screenshots of web pages for visual documentation Generate full-page screenshots for website previews Automate screenshot capture in AI-enhanced workflows Create snapshots of local HTML files for testing Customize viewport size for responsive design validation Save screenshots to custom output directories

README

MCP Screenshot Server

An MCP server implementation that provides screenshot functionality using Puppeteer. This server allows capturing screenshots of web pages and local HTML files through a simple MCP tool interface.

Features

Capture screenshots of any web page or local HTML file
Configurable viewport dimensions
Full page screenshot support
Custom output path option
Automatic screenshot directory management

Installation

npm install

Usage

The server provides a take_screenshot tool with the following options:

{
  url: string;         // URL to capture (can be http://, https://, or file:///)
  width?: number;      // Viewport width in pixels (1-3840)
  height?: number;     // Viewport height in pixels (1-2160)
  fullPage?: boolean;  // Capture full scrollable page
  outputPath?: string; // Custom output path (optional)
}

Development

# Build the project
npm run build

# Run the MCP inspector for testing
npm run inspector

License

MIT

mcp-screenshot-server FAQ

How do I install the mcp-screenshot-server?

Install it via npm using 'npm install', then build and run as per the README instructions.

Can I capture screenshots of local HTML files?

Yes, the server supports URLs with the 'file://' protocol for local files.

How do I specify the viewport size for screenshots?

Use the 'width' and 'height' options in the 'take_screenshot' tool to set viewport dimensions.

Is it possible to capture full scrollable pages?

Yes, set the 'fullPage' option to true to capture the entire scrollable page.

Can I define where screenshots are saved?

Yes, use the 'outputPath' option to specify a custom file path for the screenshot.

Does the server manage screenshot directories automatically?

Yes, it handles directory creation and management for saving screenshots.

What dependencies does the server use?

It uses Puppeteer for browser automation and screenshot capture.

Can this server be integrated with different LLM providers?

Yes, it can be used with models from OpenAI, Anthropic Claude, and Google Gemini via MCP.