A11yDriver Engine

Zero-UI Chrome Extension & MCP Server Bridge for Autonomous AI Agents

Engineered with ❤️ by Eliyanto Sarage • officialelsa21@gmail.com

⚡ Key Highlights & Architecture

• 🛡️ Zero-UI Background Operator: Operates 100% silently in Chrome service worker without popup or sidepanel overhead.

• 🌳 Accessibility Tree Serializer (a11y-engine.js): Converts complex DOM + Shadow DOM trees into compressed semantic trees with refId tracking, saving up to 80% LLM tokens.

• 🧰 21 Full CDP MCP Tools: Complete browser control including Tab Group sessions, drag-and-drop, full-page screenshots, PDF export, hover triggering, and key pressing.

• 🔒 Sensitive Data Redaction: Automatic local masking of password fields, OTPs, and credit card credentials.

• ⏱️ Manifest V3 Keep-Alive: Heartbeat alarms prevent Service Worker sleep during extended AI agent sessions.

Related MCP server: Chrome MCP Server

🚀 Quick Setup

1. Install Global MCP Server

npm install -g a11ydriver-mcp

2. Configure AI Agent (Claude Code / Claude Desktop / Custom Agent Host)

Add a11ydriver-mcp to your MCP configuration:

{
  "mcpServers": {
    "a11ydriver": {
      "command": "a11ydriver-mcp"
    }
  }
}

3. Load Extension in Chrome

1. Open chrome://extensions in Google Chrome.

2. Turn on Developer mode.

3. Click Load unpacked and select the extension/ directory.

4. Enable Agent Diagnostic Protocol (System Prompt)

Copy and paste the prompt in AGENT_INSTRUCTIONS.md into your AI Agent's system instructions. This ensures the AI Agent automatically detects whether MCP & Extension are connected and diagnoses any missing setup steps.

🛠️ Complete MCP Tool Protocol (21 Tools)

Developed by Eliyanto Sarage (officialelsa21@gmail.com)

Released under the MIT License.