mcp-browser-lens by EzraApple - MCP Server

🔍 MCP Browser Lens

AI-powered browser automation and visual inspection - Give your AI assistant eyes to see, capture, and analyze any webpage. One-line installation with automatic Chrome integration.

Turn any webpage into AI context instantly: "Look at this Stripe pricing page and help me build something similar" or "Compare my localhost dashboard with this Notion page design".

🚀 One-Line Installation

Just add this to your mcp.json and restart your AI assistant:

{
  "mcpServers": {
    "mcp-browser-lens": {
      "command": "npx",
      "args": ["-y", "mcp-browser-lens"]
    }
  }
}

That's it! No cloning, no building, no setup required.

⚡ What Happens Next?

When you restart your AI assistant (Cursor, etc.):

✅ MCP Browser Lens will be ready to:

Accept AI commands for browser automation
Initialize Chrome debugging when first needed
Capture, analyze, and extract web content on demand

Smart Chrome Management: Your AI assistant will automatically initialize Chrome debugging when it first needs to interact with browser tabs.

💬 Example AI Commands

Once configured, you can use natural language commands like:

"Take a screenshot of this page and suggest design improvements"

"Show me all my open tabs and summarize what's in each one"

"Extract the main navigation elements from this website"

"Compare this page layout with the Stripe pricing page"

"Help me debug the CSS issues on my localhost development site"

"Capture the checkout flow from this e-commerce site"

"Get the color palette and typography from this design system"

🛠️ Available MCP Tools

Tool	Description
`initialize_chrome_debugging`	Start Chrome with debugging enabled (called automatically when needed)
`list_tabs`	List all open browser tabs with titles and URLs
`capture_page_content`	Extract HTML and CSS content from browser tabs
`capture_screenshot`	Take high-quality screenshots of specific tabs
`extract_elements`	Get detailed element information using CSS selectors
`scroll_page`	Scroll pages (pixels, viewport, to elements, top/bottom)
`set_active_tab`	Switch to a specific tab safely
`get_browser_capabilities`	Check what browser features are available

🌐 Browser Support

✅ Currently Supported

Chrome/Chromium - Full support with intelligent debugging initialization

🔄 Future Support (Optional)

Safari - WebKit Remote Inspector integration (complex setup)
Firefox/Zen - Gecko debugging protocol support (different architecture)
Arc Browser - Chromium-based support (should work with Chrome provider)

Note: Chrome provides the best debugging experience and widest compatibility. MCP Browser Lens intelligently manages Chrome debugging setup, launching Chrome with debugging when needed.

🖥️ System Requirements

Node.js 18.0.0 or higher
Google Chrome (any recent version)
macOS, Windows, or Linux

👩‍💻 Development & Contributing

Want to contribute or run locally?

# Clone and setup
git clone https://github.com/EzraApple/mcp-browser-lens.git
cd mcp-browser-lens
npm install
npm run build

Then use the local version in your mcp.json:

{
  "mcpServers": {
    "mcp-browser-lens": {
      "command": "node",
      "args": ["/path/to/mcp-browser-lens/dist/index.js"]
    }
  }
}