Community MCP Tool: cdpilot — Lightweight browser automation (50KB, zero-dependency)

What is cdpilot?

cdpilot is a zero-dependency browser automation CLI with a built-in MCP server, designed specifically for AI agent workflows like Claude Code.

Instead of installing Playwright (200MB+) or Puppeteer (400MB+), cdpilot connects to your existing browser via CDP at ~50KB total.

MCP Setup for Claude Code

{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": ["cdpilot", "mcp"]
    }
  }
}

What Claude can do with cdpilot

• Navigate to any URL and read page content
• Take screenshots (returned as base64)
• Click elements, fill forms, submit
• Read accessibility trees (structured data, much better than raw HTML for AI)
• Monitor console logs and network requests
• Emulate mobile devices (iPhone, iPad, Android)
• Override geolocation
• Intercept and mock network requests
• Execute JavaScript on the page
• Export pages as PDF

Why cdpilot for Claude Code?

| Feature | cdpilot | Playwright MCP |
|---------|---------|---------------|
| Install size | ~50KB | 200MB+ |
| Dependencies | 0 | 30+ |
| Browser download | No (uses existing) | Yes (Chromium) |
| Visual feedback | Green glow, cursor vis, ripples | None |
| Multi-project | Auto port isolation | Manual |
| a11y tree | Yes | Yes |

Key differentiator: Visual feedback

When Claude controls the browser, cdpilot shows:

• Green glow overlay (automation active indicator)
• Cursor visualization (where clicks happen)
• Click ripple effects
• Keystroke display
• Red warning toast when user hovers during AI control

This makes it easy for users to understand what the AI agent is doing.

Links

• GitHub: https://github.com/mehmetnadir/cdpilot
• npm: npx cdpilot launch
• License: MIT
• Install: npx cdpilot setup (auto-detects browser, creates isolated profile)

Feedback from the Claude Code community would be very valuable!