chromedp-mcp

KePatrick/chromedp-mcp

3.3

If you are the rightful owner of chromedp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

chromedp-mcp is a Model Context Protocol server that facilitates browser automation using chromedp, enabling AI assistants to interact with web pages and perform various automation tasks.

chromedp-mcp is a cutting-edge Model Context Protocol (MCP) server designed to provide robust browser automation capabilities through the use of chromedp. This server empowers AI assistants to seamlessly interact with web pages, manage multiple browser instances, and execute a wide range of web automation tasks. The server is currently under development, and while it offers a comprehensive suite of features, users should be aware that some functionalities may still be incomplete or unstable. The primary goal of chromedp-mcp is to enhance the decision-making capabilities of AI by providing them with both visual and structured information from web pages. This includes capturing screenshots, extracting clean DOM structures, and simulating user interactions such as clicks and keyboard inputs. The server is highly configurable, allowing users to manage Chrome instances with various settings for headless operation, security, and performance optimization. Additionally, chromedp-mcp supports advanced operations like PDF generation, file downloads, and cookie management, making it a versatile tool for developers and AI researchers alike.

Features

  • Multi-instance Chrome Management: Create and manage multiple Chrome browser instances with extensive configuration options.
  • Complete Page Navigation: Navigate to URLs and manage browser history with back and forward navigation.
  • Element Interaction: Find, click, and interact with web page elements using various selectors.
  • Screen Capture: Take screenshots of web pages for visual analysis.
  • PDF Generation: Convert web pages or HTML content to PDF documents.

Usages

basic configuration

{
  "mcpServers": {
    "chromedp-mcp": {
      "command": "/path/to/chromedp-mcp",
      "args": []
    }
  }
}

with environment variables

{
  "mcpServers": {
    "chromedp-mcp": {
      "command": "/path/to/chromedp-mcp",
      "args": [],
      "env": {
        "CHROME_MAXIMUM_INSTANCE": "10",
        "CHROME_TTL": "30",
        "CHROME_EXE_TIMEOUT": "600"
      }
    }
  }
}

Tools

  1. create-chrome-instance

    Create a new Chrome browser instance with extensive configuration options.

  2. navigate

    Navigate to a specified URL and return clean DOM structure.

  3. click-element

    Click on an element with support for different click types.

  4. screenshot

    Capture screenshots of web pages for visual analysis.

  5. generate_pdf

    Generate PDF from HTML content or URL.