explaingit

hangwin/mcp-chrome

11,612TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Chrome extension that lets AI assistants like Claude control your real Chrome browser, clicking, navigating, taking screenshots, and searching history, while keeping you logged in to all your existing accounts.

Mindmap

mindmap
  root((repo))
    What it does
      AI controls Chrome browser
      MCP protocol bridge
      Works in real profile
    Capabilities
      Open URLs and click
      Screenshots any tab
      Semantic tab search
      Bookmarks and history
    How it works
      Chrome extension
      Local bridge npm package
      WebAssembly vector search
    Setup needs
      Developer mode Chrome
      mcp-chrome-bridge install
      MCP-compatible AI client
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Let an AI assistant navigate and interact with sites you are already signed in to, without re-entering passwords.

USE CASE 2

Use an AI to take screenshots of open tabs, search browser history, and manage bookmarks automatically.

USE CASE 3

Enable semantic search across all open tabs so an AI can find relevant content by meaning rather than exact keywords.

Tech stack

TypeScriptChrome Extension APIWebAssemblynpm

Getting it running

Difficulty · moderate Time to first run · 30min

Requires installing the Chrome extension in developer mode and running mcp-chrome-bridge as an npm package alongside your MCP-compatible AI client.

MIT license: use, copy, modify, and distribute freely for any purpose including commercial use, as long as you keep the copyright notice.

In plain English

Chrome MCP Server is a Chrome browser extension that lets AI assistants control your Chrome browser directly. It works by implementing the Model Context Protocol (MCP), which is a standard way for AI tools like Claude to communicate with external software. Once the extension is installed and a small bridge program is running on your computer, an AI assistant can open URLs, click things, take screenshots, search your history, manage bookmarks, and more, all through your existing Chrome window. The key difference from older browser automation tools is that this extension runs inside your real Chrome profile. That means the AI is working in the same browser where you are already signed in to your accounts, and with your saved preferences and extensions in place. Traditional automation tools typically launch a fresh, empty browser instance where you would need to log in again to every site. The extension includes over 20 tools covering browser management, screenshots, page interaction, bookmarks, history, and a semantic search feature that uses a vector database to find relevant content across your open tabs. The semantic search is accelerated using a custom WebAssembly SIMD optimization that the README says produces a 4x to 8x speed improvement for the underlying vector operations. Setup requires installing the Chrome extension manually in developer mode, then installing a companion npm package called mcp-chrome-bridge. Once both are running, you point your MCP-compatible AI client at a local HTTP address and the browser tools become available to it. The project is MIT licensed and still described as being in early-stage development.

Copy-paste prompts

Prompt 1
I installed the mcp-chrome extension and the mcp-chrome-bridge npm package. Help me configure Claude Desktop to connect to it so I can control Chrome from Claude.
Prompt 2
Show me how to use the mcp-chrome browser tools to have an AI automatically fill a web form on a site where I am already logged in.
Prompt 3
I want to use mcp-chrome semantic tab search. Explain how the vector database works and how to trigger a semantic search from an AI prompt.
Prompt 4
Walk me through the mcp-chrome-bridge setup on Windows, where does the config file go and what port does the local bridge server listen on?
Open on GitHub → Explain another repo

← hangwin on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.