Autoconsent MCP

A Model Context Protocol server that provides browser automation capabilities specifically designed for creating and testing Autoconsent rules. This server enables LLMs to interact with web pages, inspect consent management platforms (CMPs), and test Autoconsent rules in a real browser environment.

[!CAUTION] This server can access local files and local/internal IP addresses since it runs a browser on your machine. Exercise caution when using this MCP server to ensure this does not expose any sensitive data.

Components

Tools

• navigate

  • Navigate to any URL in the browser
  • Inputs:
    • url (string, required): URL to navigate to

• screenshot

  • Capture screenshots of the entire page or specific elements
  • Inputs:
    • name (string, required): Name for the screenshot
    • width (number, optional, default: 1280): Screenshot width
    • height (number, optional, default: 720): Screenshot height
    • encoded (boolean, optional): If true, capture the screenshot as a base64-encoded data URI (as text) instead of binary image content. Default false.

• click

  • Click elements on the page
  • Input: selector (string): CSS selector for element to click

• select

  • Select an element with SELECT tag
  • Inputs:
    • selector (string): CSS selector for element to select
    • value (string): Value to select

• evaluate

  • Execute JavaScript in the browser console
  • Input: script (string): JavaScript code to execute

• search_html

  • Outputs the HTML of elements that deeply contain the given search query. Elements that don't contain the given query are omitted using a [...] placeholder.
  • Input: query (string): Search query

• print_element

  • Outputs the full HTML of the given element
  • Input: selector (string): CSS selector

• test_rule

  • Tests the given Autoconsent rule on the given URL
  • Inputs:
    • url (string, required): URL to navigate to
    • rule (object, required): Autoconsent rule (AutoConsentCMPRule)

Resources

The server provides access to two types of resources:

1. Console Logs (console://logs)

   • Browser console output in text format
   • Includes all console messages from the browser

2. Screenshots (screenshot://)

   • PNG images of captured screenshots
   • Accessible via the screenshot name specified during capture

Installation and Setup

Prerequisites

• Node.js (version 18 or higher)
• npm

Setup

npm install
npm run build

Running the Server

For development:

npm run dev

For production:

npm start

Test Site

npm run serve-test-site

This starts a local HTTP server on port 8080 serving the test-site directory.

Testing

npm run test:unit
npm run test:integration

Note that the integration tests require the test site to be running (see above).

Configuration for Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "autoconsent-mcp": {
      "command": "node",
      "args": ["path/to/autoconsent-mcp/dist/index.js"]
    }
  }
}

Attribution and license

This project is based on the Puppeteer MCP server from https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer.

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.