Autoconsent MCP

# 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 ```bash npm install npm run build ``` ### Running the Server For development: ```bash npm run dev ``` For production: ```bash npm start ``` ### Test Site ```bash npm run serve-test-site ``` This starts a local HTTP server on port 8080 serving the `test-site` directory. ### Testing ```bash 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: ```json { "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.