Browser Mcp Lite banner
notoriouslab notoriouslab

Browser Mcp Lite

Development community

Description

Minimal, auth-secured MCP server for real browser access. ~500 lines. Token auth, Chrome Extension MV3, accessibility tree.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

browser-mcp-lite

[![npm version](https://img.shields.io/npm/v/browser-mcp-lite?color=cb3837&logo=npm)](https://www.npmjs.com/package/browser-mcp-lite) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![MCP](https://img.shields.io/badge/MCP-compatible-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiPjxyZWN0IHg9IjIiIHk9IjIiIHdpZHRoPSIyMCIgaGVpZ2h0PSIyMCIgcng9IjMiLz48cGF0aCBkPSJNOCA4aDgiLz48cGF0aCBkPSJNOCAxMmg4Ii8+PHBhdGggZD0iTTggMTZoNSIvPjwvc3ZnPg==)](https://modelcontextprotocol.io) [![Chrome Extension](https://img.shields.io/badge/Chrome-Extension-4285F4?logo=googlechrome&logoColor=white)](https://developer.chrome.com/docs/extensions/) [![Code Style: ~500 lines](https://img.shields.io/badge/Code-~500_lines-green)](https://github.com/notoriouslab/browser-mcp-lite)

[繁體中文](README.zh-TW.md) | English

**Give your AI assistant eyes into your real browser — in ~500 lines of code.**

A minimal, auth-secured [MCP](https://modelcontextprotocol.io/) server that lets AI assistants read pages, take screenshots, and run scripts in your actual Chrome browser — with your existing login sessions intact.

AI Assistant ──HTTP POST──▶ MCP Server (:12307) ──WebSocket──▶ Chrome Extension ──▶ DOM
                            (token auth)           (ws://)       (minimal permissions)

Why build your own?

Existing browser MCP solutions are either:

  • Too heavymcp-chrome requires debugger, history, permissions, ships minified code you can't audit
  • Headless onlyPlaywright MCP launches a new browser, can't see your logged-in sessions
  • Cloud-dependent — Browserbase, etc. route your pages through third-party servers

browser-mcp-lite