Back to search
antigravity-headless-puppeteer
MCP serverGitHub
One-command Puppeteer MCP setup for Antigravity CLI on headless Linux servers
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/advisingdesert--antigravity-headless-puppeteer)HTML
<a href="/listings/advisingdesert--antigravity-headless-puppeteer"><img src="/api/listings/advisingdesert--antigravity-headless-puppeteer/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/AdvisingDesert/antigravity-headless-puppeteer.git cd antigravity-headless-puppeteer chmod +x setup.sh start_mcp.sh ./setup.sh
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 42 lines
- # Antigravity CLI — Headless Puppeteer MCP (Linux)
- One-command setup to give **Antigravity (`agy`)** full web browsing capabilities on a headless Linux server (Ubuntu 24.04 / Debian) using the official Puppeteer MCP server.
- ## Why this exists
- Setting up `@modelcontextprotocol/server-puppeteer` on a headless server usually fails silently, leaving the agent without browser tools. This repo fixes the three main blockers out of the box:
- - **Ubuntu 24.04 `t64` transition:** handles the `libasound2` → `libasound2t64` package change automatically.
- - **Root cache lockouts:** bypasses `/root/.cache/puppeteer` permission errors caused by global `sudo npm` installs.
- - **Snap/System Chromium routing:** dynamically points Puppeteer to the system Chromium binary via a lightweight wrapper.
- ## Requirements
- - Ubuntu / Debian Linux (headless)
- - Node.js & `npm`
- - Antigravity CLI (`agy`)
- ## Quick Start
- ```bash
- git clone https://github.com/AdvisingDesert/antigravity-headless-puppeteer.git
- cd antigravity-headless-puppeteer
- chmod +x setup.sh start_mcp.sh
- ./setup.sh
- ```
- ## Verify
- check that the MCP server is active:
- ```bash
- agy mcp list
- ```
- Run a quick browsing test:
- ```bash
- agy --dangerously-skip-permissions --print "Use puppeteer to visit example.com and return only the exact page title."
- ```
- ## How it works
- agy CLI ──► start_mcp.sh (sets PUPPETEER_EXECUTABLE_PATH) ──►
- @modelcontextprotocol/server-puppeteer ──► System Chromium
- - setup.sh installs the headless X11/ALSA dependencies, installs the MCP package globally, and registers start_mcp.sh in agy
- - start_mcp.sh is the entry point executed by agy in the background whenever you start a session.
- Once installed, Puppeteer is available globally across all your agy projects on the server.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.