Skip to main content
Glama
idugeni

a11ydriver-mcp

by idugeni
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

A11yDriver Engine

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

NPM Version License: MIT PRs Welcome

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)

Tool Category

MCP Tool Name

Description

Tab & Group

browser_list_tabs

List all open Chrome tabs with IDs & titles

browser_new_tab

Open a new tab (optional url, groupId)

browser_create_agent_group

Create an isolated tab group for AI agent session

browser_cleanup_agent_group

Close all tabs inside an agent tab group after task finishes

browser_switch_tab

Switch active focused tab by tabId

browser_close_tab

Close specified tab by tabId

Navigation

browser_navigate

Navigate active tab to target url

browser_go_back

Go back in browser history

browser_go_forward

Go forward in browser history

browser_reload

Reload current page

Interactions

browser_click

Click element by coordinates (x, y) or element refId

browser_hover

Hover cursor over element or (x, y) coordinates

browser_drag_and_drop

Perform drag & drop from (fromX, fromY) to (toX, toY)

browser_type

Type text into element refId or active input

browser_press_key

Press special keys (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp)

browser_scroll

Scroll page vertically (deltaY) or horizontally (deltaX)

DOM & Output

browser_get_a11y_tree

Get semantic Accessibility Tree snapshot with refId

browser_evaluate_script

Execute custom JS snippet on web context via CDP Runtime

browser_screenshot

Capture tab screenshot (supports fullPage: true)

browser_print_to_pdf

Print web page to PDF base64 document

browser_get_cookies

Get session cookies for active domain

Developed by Eliyanto Sarage (officialelsa21@gmail.com)

Released under the MIT License.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Chrome Profile MCP Server

    nghiahsgs
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI agents to control a real Google Chrome instance using specific user profiles, cookies, and extensions. It provides 18 tools for browser navigation, element interaction, and page inspection via the Chrome DevTools Protocol.
    -

  • Chrome MCP Server

    davincinewton
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    An extension-based MCP server that enables AI assistants to control your existing Chrome browser, leveraging your active login states and settings for automation. It provides over 20 tools for tasks like semantic tab search, screen capture, network monitoring, and direct element interaction.
    -

  • kilo-computer-use

    123itsfree
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    MCP server that connects AI agents to a real Chrome browser via a WebSocket extension bridge, enabling over 40 browser control tools without debug mode or profile isolation.
    -

  • MCP Chrome Bridge

    wizardofweb125-lab
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to control Chrome browser actions like navigation, clicking, form filling, screenshots, and console/network logging via an MCP server and Chrome extension.
    545 npm
    MIT