🐼 Lightpanda MCP Server

A 100% project-agnostic, multi-runtime Model Context Protocol (MCP) server for Lightpanda — the ultra-fast AI-native headless browser (16x lower memory footprint than Chrome).

Supports NPM, Bun, PNPM, Yarn, Go, Python/UVX, and connects OpenCode, Claude Code, Codex, Antigravity, Cursor, Windsurf, or LangChain seamlessly!

---

🚀 Installation & Execution Methods

⚡ 1. NPM / NPX (Node.js)

# Zero-install execution via NPX
npx lightpanda-mcp-server

# Or global install
npm install -g lightpanda-mcp-server

MCP Config:

{
  "mcpServers": {
    "lightpanda": {
      "command": "npx",
      "args": ["-y", "lightpanda-mcp-server"]
    }
  }
}

---

🥟 2. BUN / BUNX

# Zero-install execution via Bunx
bunx lightpanda-mcp-server

# Or global install via Bun
bun add -g lightpanda-mcp-server

MCP Config:

{
  "mcpServers": {
    "lightpanda": {
      "command": "bunx",
      "args": ["lightpanda-mcp-server"]
    }
  }
}

---

📦 3. PNPM / DLX

pnpm dlx lightpanda-mcp-server

MCP Config:

{
  "mcpServers": {
    "lightpanda": {
      "command": "pnpm",
      "args": ["dlx", "lightpanda-mcp-server"]
    }
  }
}

---

🧶 4. YARN / DLX

yarn dlx lightpanda-mcp-server

---

🐹 5. GO (go install / go run)

# Global Go install
go install github.com/Brilhante29/lightpanda-mcp-server@latest

MCP Config:

{
  "mcpServers": {
    "lightpanda": {
      "command": "lightpanda-mcp-server"
    }
  }
}

---

🐍 6. PYTHON / UVX (pip / uvx)

uvx lightpanda-mcp-server

MCP Config:

{
  "mcpServers": {
    "lightpanda": {
      "command": "uvx",
      "args": ["lightpanda-mcp-server"]
    }
  }
}

---

🛠️ Provided MCP Tools

Tool Name	Description	Parameters
lightpanda_fetch_html	Ultra-fast HTML extraction from any URL.	url (string)
lightpanda_get_markdown	Extracts clean Markdown & Accessibility Tree (AX Tree).	url (string)
lightpanda_execute_js	Evaluates JavaScript inside Lightpanda headless browser over CDP.	url (string), script (string)
lightpanda_status	Checks local Lightpanda daemon health and CDP WebSocket connectivity.	None

---

⚙️ Environment Variables

• LIGHTPANDA_HOST (default: 127.0.0.1): Host IP of local Lightpanda daemon.
• LIGHTPANDA_PORT (default: 9222): Port of local Lightpanda CDP server.

---

📄 License

MIT License © Guilherme Brilhante & Lightpanda Community.