🌟 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 | 中文

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.

• 😁 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

• Node.js 18+ and pnpm
• Chrome/Chromium browser

1. Download the latest Chrome extension from GitHub

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

2. Install mcp-chrome-bridge globally

npm

npm install -g mcp-chrome-bridge

pnpm

pnpm install -g mcp-chrome-bridge --unsafe-perm

Note: When using pnpm, the --unsafe-perm flag is required to ensure post-installation scripts run properly, which is necessary for registering the Native Messaging host.

3. 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
   

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"
    }
  }
}

If your client only supports stdio connection method, please use the following approach:

1. First, check the installation location of the npm package you just installed

# npm check method
npm list -g mcp-chrome-bridge
# pnpm check method
pnpm list -g mcp-chrome-bridge

Assuming the command above outputs the path: /Users/xxx/Library/pnpm/global/5 Then your final path would be: /Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js

2. Replace the configuration below with the final path you just obtained

{
  "mcpServers": {
    "chrome-mcp-stdio": {
      "command": "npx",
      "args": [
        "node",
        "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"
      ]
    }
  }
}

eg：config in augment:

Complete tool list: Complete Tool List

prompt: excalidraw-prompt Instruction: Help me summarize the current page content, then draw a diagram to aid my understanding.

prompt: excalidraw-prompt|content-analize Instruction: First, analyze the content of the image, and then replicate the image by combining the analysis with the content of the image.

prompt: modify-web-prompt Instruction: Help me modify the current page's style and remove advertisements.

query: I want to know what the search API for Xiaohongshu is and what the response structure looks like

query: Analyze my browsing history from the past month

query: Translate and summarize the current web page

query: Take a screenshot of Hugging Face's homepage

query: Capture the icon from Hugging Face's homepage

query: Add the current page to bookmarks and put it in an appropriate folder

query: Close all shadcn-related web pages

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines.

We have exciting plans for the future development of Chrome MCP Server:

• Authentication
• Recording and Playback
• Workflow Automation
• Enhanced Browser Support (Firefox Extension)

Want to contribute to any of these features? Check out our Contributing Guide and join our development community!

This project is licensed under the MIT License - see the LICENSE file for details.

• Architecture Design - Detailed technical architecture documentation
• TOOLS API - Complete tool API documentation
• Troubleshooting - Common issue solutions