Webtools MCP Server logo

Webtools MCP Server

by bschauer

The Webtools MCP Server provides comprehensive web analysis tools, including HTML extraction, markdown conversion, and screenshot capabilities. It also offers advanced performance analysis and Lighthouse-powered web audits.

View on GitHub

Last updated: N/A

What is Webtools MCP Server?

A Model Context Protocol server offering a suite of web analysis tools. It leverages Puppeteer to provide functionalities like HTML extraction, markdown conversion, screenshot capture, debugging, and comprehensive web audits using Lighthouse.

How to use Webtools MCP Server?

Install the server globally using npm install -g @bschauer/webtools-mcp-server or use it directly with npx @bschauer/webtools-mcp-server. Configure the server via a configuration file or environment variables. Use the provided tool functions (e.g., webtool_gethtml, webtool_screenshot) with appropriate parameters to analyze websites.

Key features of Webtools MCP Server

  • HTML extraction with JavaScript rendering and proxy support

  • Markdown conversion with clean content extraction and link preservation

  • Screenshot capture with full page, element-specific, and device emulation options

  • Debug console for capturing console output, network requests, and errors

  • Lighthouse-powered web audits for performance, accessibility, SEO, and best practices

  • Advanced performance analysis tools including layout thrashing detection and network activity analysis

  • Code coverage analysis for identifying unused JavaScript and CSS

  • Core Web Vitals analysis for LCP, CLS, FID/INP, and TTFB

  • Cross-device and network testing for comparative analysis

Use cases of Webtools MCP Server

  • Analyzing website performance and identifying bottlenecks

  • Extracting content from web pages and converting it to markdown

  • Capturing screenshots of web pages for visual documentation

  • Debugging web applications and identifying errors

  • Auditing websites for accessibility and SEO issues

  • Optimizing website code for performance

  • Monitoring network activity and identifying optimization opportunities

  • Comparing website performance across different devices and network conditions

FAQ from Webtools MCP Server

How do I enable proxy support?

Set the USE_PROXY environment variable to true and configure the PROXY_URL and PROXY_TIMEOUT variables.

How do I specify a device for screenshot capture?

Use the deviceConfig parameter in the webtool_screenshot function to specify the width, height, deviceScaleFactor, and isMobile properties.

How do I run only specific Lighthouse audits?

Use the categories parameter in the webtool_lighthouse function to specify the categories you want to audit (e.g., ['performance', 'seo']).

How do I detect layout thrashing?

Set captureLayoutThrashing to true in the webtool_debug function.

How do I analyze network activity?

Use the webtool_network_monitor function with appropriate parameters like waitAfterLoadMs, includeThirdParty, and captureTimings.