Webtools MCP Server

🚀 Network Tool MCP Server

The Network Tool MCP Server is a comprehensive Web analysis platform that integrates various tools for website analysis, performance testing, and quality assurance. It offers the following key features:

1. HTML Page Scraping: Retrieve web page content with JavaScript rendering support.
2. Screenshot Generation: Capture web page views and return Base64-encoded PNG images.
3. Lighthouse Audit: Conduct Lighthouse audits to analyze website performance and SEO.
4. Performance Testing: Simulate real user scenarios across different devices and network conditions.
5. Code Coverage Analysis: Evaluate JavaScript code usage.
6. Debugging Tools: Diagnose page errors and monitor layout shifts.

📋 Tool Descriptions

Web Page Scraping Tool

• Basic Function: Retrieve the HTML content of a web page.
• Parameter Options:
  • url: Required. The target URL.
  • waitForSelector: Optional. Default is null. Wait for a specific selector to appear.
  • timeout: Default is 30 seconds. Set the timeout period.

Screenshot Tool

• Features:
  • Return a Base64-encoded PNG image.
  • Support custom viewport size and zoom level.
  • Provide a URL link for screenshot preview.

Lighthouse Audit Tool

• Core Metrics:
  • First Contentful Paint (FCP)
  • Largest Contentful Paint (LCP)
  • Time to Interactive (TTI)
  • Cumulative Layout Shift (CLS)

💻 Response Format

All tools adopt the following unified response format:

{
  "content": [
    {
      "type": "text",
      "text": "..." // Markdown-formatted report
    }
  ]
}

Screenshot Example

{
  "content": [
    {
      "type": "image",
      "data": "...", // Base64-encoded PNG
      "mimeType": "image/png"
    }
  ]
}

💡 Best Practices

1. Analyze Step by Step: Start with basic HTML scraping and then use advanced analysis tools.
2. Render on Demand: Enable rendering only when JavaScript content is needed.
3. Set Timeouts Reasonably: Set a sufficiently long timeout for complex pages.
4. Use Selectors: Specify the target area with selectors to optimize the scraping scope.
5. Use Proxies Conditionally: Enable proxies only when accessing geographically restricted content.

🛠️ Troubleshooting

Chrome Installation Issue

• Note: Chrome is automatically installed via Puppeteer. No additional action is required.
• Solution: If you encounter issues, reinstall the package npm install -g @bschauer/webtools-mcp-server.

Connection Issue

• Symptom: Unable to connect to the website.
• Troubleshooting: Check the URL format, website availability, or enable a proxy.

🔒 Security Considerations

• The tools can access any website. Use them with caution.
• Use the proxy function carefully and comply with relevant laws and regulations.
• Keep SSL certificate verification enabled unless absolutely necessary.

🤝 Contribution and License

This project follows the MIT license. The community is welcome to contribute code and documentation.

For more information, please refer to the original English documentation or contact the development team directly.