Chrome MCP Server

Turn your Chrome browser into your intelligent assistant - Let AI take control of your browser, transforming it into a powerful AI-controlled automation tool.

** Documentation**: English | 中文

The project is still in its early stages and is under intensive development. More features, stability improvements, and other enhancements will follow.

What is Chrome MCP Server?

Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search. Unlike traditional browser automation tools (like Playwright), Chrome MCP Server directly uses your daily Chrome browser, leveraging existing user habits, configurations, and login states, allowing various large models or chatbots to take control of your browser and truly become your everyday assistant.

Core Features

• Chatbot/Model Agnostic: Let any LLM or chatbot client or agent you prefer automate your browser
• Use Your Original Browser: Seamlessly integrate with your existing browser environment (your configurations, login states, etc.)
• Fully Local: Pure local MCP server ensuring user privacy
• Streamable HTTP: Streamable HTTP connection method
• Cross-Tab: Cross-tab context
• Semantic Search: Built-in vector database for intelligent browser tab content discovery
• Smart Content Analysis: AI-powered text extraction and similarity matching
• 20+ Tools: Support for screenshots, network monitoring, interactive operations, bookmark management, browsing history, and 20+ other tools
• SIMD-Accelerated AI: Custom WebAssembly SIMD optimization for 4-8x faster vector operations

Comparison with Similar Projects

Quick Start

Prerequisites

• Node.js >= 18.19.0 and pnpm/npm
• Chrome/Chromium browser

Installation Steps

1. Download the latest Chrome extension from GitHub

Download link: https://github.com/hangwin/mcp-chrome/releases

1. Install mcp-chrome-bridge globally

npm

npm install -g mcp-chrome-bridge

pnpm

# Method 1: Enable scripts globally (recommended)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridge

# Method 2: Manual registration (if postinstall doesn't run)
pnpm install -g mcp-chrome-bridge
mcp-chrome-bridge register

Note: pnpm v7+ disables postinstall scripts by default for security. The enable-pre-post-scripts setting controls whether pre/post install scripts run. If automatic registration fails, use the manual registration command above.

1. Load Chrome Extension
   • Open Chrome and go to chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked" and select your/dowloaded/extension/folder
   • Click the extension icon to open the plugin, then click connect to see the MCP configuration <img width="475" alt="Screenshot 2025-06-09 15 52 06" src="https://github.com/user-attachments/assets/241e57b8-c55f-41a4-9188-0367293dc5bc" />

Usage with MCP Protocol Clients

Using Streamable HTTP Connection ( Recommended)

Add the following configuration to your MCP client configuration (using CherryStudio as an example):

Streamable HTTP connection method is recommended

{
  "mcpServers": {
    "chrome-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

Using STDIO Connection (Alternative)

If your client only supports stdio connection method, pl…