antigravity-chrome
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Antigravity Chrome Connector
Ultra-fast, banner-free Manifest V3 Chrome Extension + Shared Localhost Hub + MCP Server for Google Antigravity (also compatible with Claude Code & Cursor).
Built from scratch to be faster, leaner on tokens, and more accurate on modern SPAs than standard remote-debugging or single-step browser connectors.
Highlights (v2.0.0)
~1 ms local bridge, ~19 ms DOM snapshots, ~45 ms screenshots — Content engine is injected on-demand only into target tabs (zero overhead on regular browsing) and keeps your MV3 service worker warm via 15s WebSocket heartbeats +
chrome.alarmswatchdog.Zero Chrome Remote Debugging Flags or Re-Consent Popups — No
--remote-debugging-portlaunch hacks, no 60-second consent dialogs on restart, and no yellow Chrome debugger banner during normal browsing.Cross-Frame
<iframe>& Open Shadow DOM Support — Automatically traverses open Shadow DOM and accessible subframes, indexing iframe controls cleanly as[f<frameId>:<ref>]so clicks, typing, hovers, and selects work inside embedded frames.Modal-First + SPA-Aware + Occlusion-Aware Snapshots — Surfaces
<dialog>/[aria-modal="true"]overlays first, detects React/Vuecursor: pointerclick targets without duplicate child noise, collapses repetitive links, and flags(covered)elements viaelementFromPointhit-testing.70–90% Token Savings with Diff Snapshots (
diff: true) & Instantbrowser_find— Fetch only+added/-removedelements after SPA updates, or locate any control in<5 mswithout dumping the full page.Single-Round-Trip Batched Execution (
browser_batch) — Chain up to 30 steps (type,click,hover,drag,select,press_key,scroll,wait,navigate,assert_text,assert_url) + a compact final snapshot in one MCP tool call.Set-of-Marks (SoM) Visual Screenshots (
annotate: true) — Temporarily draws numbered[ref]pills directly onto visible controls for visual/icon-heavy UIs and removes them immediately after capture.On-Demand
chrome.debugger(CDP) Elevation — Passtrusted: truefor hardware-levelevent.isTrustedclicks/keystrokes/smooth drags or CSP-free eval, or attach for livebrowser_console,browser_network(with response bodies),fullPage: truescreenshots, and rawbrowser_cdp— then callbrowser_cdp(action="detach_all")to hide the banner.Multi-Session Shared Localhost Hub — Multiple concurrent Antigravity chats share one Chrome connection on
127.0.0.1:18792with zeroEADDRINUSEcollisions.Live Chrome Control UI (Toolbar Popup + Side Panel) — Real-time action feed with latencies, one-click Pause/Resume kill switch, Tab Scope (
All Tabs/Group Only/Active Tab), dedicated purple Antigravity Chrome tab group, Protected Domains denylist, and Allow JS Eval toggle.
Related MCP server: Fast Browser MCP
Comparison
Capability | Standard CDP MCP | Typical Browser Connector | Antigravity Chrome Connector |
Works on your real logged-in Chrome profile | Requires remote debug toggle | Yes | Yes (zero flags) |
Banner-free normal browsing & screenshots | No (always shows banner) | Partial | Yes (CDP on-demand only) |
Multiple concurrent agent sessions | No (port lock) | Limited | Yes (shared loopback Hub) |
Multi-step single round-trip ( | No | Limited | Yes (up to 30 steps + assertions) |
Diff snapshots ( | No | No | Yes (70–90% fewer tokens) |
Set-of-Marks annotated screenshots ( | No | Rare | Yes (auto-cleaned overlay + legend) |
Cross-frame | Partial | Partial | Yes ( |
Live Side Panel kill switch + Protected Domains | No | Partial | Yes |
Architecture
flowchart LR
AG1["Antigravity Session 1\n(MCP stdio)"] --> HUB
AG2["Antigravity Session 2\n(MCP stdio)"] --> HUB
HUB["Localhost WS Hub\n127.0.0.1:18792\n(256-bit token + Origin guard)"] <--> EXT["Chrome MV3 Service Worker\n(background.js)"]
EXT -->|"Fast banner-free path"| ENG["On-Demand Content Engine\n(Shadow DOM + iframes + SoM)"]
EXT -->|"On-demand CDP"| CDP["chrome.debugger\n(trusted input, console, network)"]
EXT <--> UI["Popup & Side Panel UI\n(Pause, Scope, Domains, Live Log)"]60-Second Quickstart
git clone https://github.com/TPZZ759/antigravity-chrome-connector.git
cd antigravity-chrome-connector
npm install
npm run setupnpm run setup automatically:
Generates a unique 256-bit auth token in
~/.antigravity-chrome/config.jsonand writes the gitignoredextension/bridge.config.json.Generates the extension icons (
16/32/48/128px).Registers
antigravity-chromein Antigravity's~/.gemini/config/mcp_config.json(use--client claudeor--client cursorfor other agents).Installs the companion Antigravity skill to
~/.gemini/config/skills/antigravity-chrome/SKILL.md.
Then load the extension once in Chrome:
Open
chrome://extensionsand enable Developer mode (top right).Click Load unpacked and select the
extension/folder inside this repo.Pin Antigravity Chrome Connector to your toolbar and refresh MCP servers in Antigravity — the badge turns green
ONautomatically.
MCP Tool Catalog (21 Tools)
Category | Tools |
Session & Tabs |
|
Reading & Discovery |
|
Interaction |
|
Inspection & On-Demand CDP |
|
Security Model
Loopback-only binding: The Hub binds strictly to
127.0.0.1(never exposed to LAN).256-bit shared token: Stored locally in
~/.antigravity-chrome/config.json(mode0600) and verified withcrypto.timingSafeEqual.extension/bridge.config.jsonis strictly.gitignored and never committed.Anti-CSWSH Origin check: WebSocket upgrades from
http://orhttps://web pages are rejected with HTTP403 Forbidden.User-in-the-loop guardrails: Instant Pause kill switch, Group Only / Active Tab isolation, Protected Domains denylist, and toggleable Allow JS Eval.
Verification
npm run verifyRuns syntax checks, MV3 manifest + icon checks, .gitignore secret hygiene checks, live Hub security tests (HTTP 403 on untrusted web Origin, HTTP 401 on invalid token), and two concurrent MCP stdio clients executing parallel tool calls (including iframe refs) through the Hub.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI clients to control the user's already-open, logged-in browser pages in real time over a local WebSocket channel, without Playwright, Puppeteer, Selenium, or any browser driver. Exposes tools for navigation, semantic page snapshots, clicking, form filling, JavaScript evaluation, screenshots, network monitoring, cookie handling, and tab management via the CDP.20MIT
- AlicenseBqualityBmaintenanceEnables AI agents and developers to automate real Chrome/Chromium browsers through the Chrome DevTools Protocol, with token-efficient snapshots, multi-action batching, shadow DOM traversal, system-page control, extension management, and network/WebSocket inspection.951MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to drive the user's real, already-logged-in Chrome browser locally, so they can read and navigate pages, click, type, fill forms, take screenshots, and inspect cookies, tabs, console, and network traffic without headless browsers or remote-debugging ports.1 npmISC
- AlicenseNot gradedqualityAmaintenanceLets AI coding tools drive the user's already-signed-in Chrome browser — reading and snapshotting pages, clicking, typing, uploading files, screenshotting, and inspecting tabs, cookies, console, and network traffic. It works through a local Chrome extension bridge, so no remote debugging port is opened and the real, authenticated browser session is used.1 npmISC