mcp-chrome

mcp-chrome

3.8

If you are the rightful owner of mcp-chrome and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that transforms your Chrome browser into an AI-controlled automation tool.

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: |

🎯 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

Comparison DimensionPlaywright-based MCP ServerChrome Extension-based MCP Server
Resource Usage❌ Requires launching independent browser process, installing Playwright dependencies, downloading browser binaries, etc.βœ… No need to launch independent browser process, directly utilizes user's already open Chrome browser
User Session Reuse❌ Requires re-loginβœ… Automatically uses existing login state
Browser Environment❌ Clean environment lacks user settingsβœ… Fully preserves user environment
API Access⚠️ Limited to Playwright APIβœ… Full access to Chrome native APIs
Startup Speed❌ Requires launching browser processβœ… Only needs to activate extension
Response Speed50-200ms inter-process communicationβœ… Faster

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ and pnpm
  • 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

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, 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

  1. 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:

πŸ› οΈ Available Tools

Complete tool list:

πŸ“Š Browser Management (6 tools)
  • get_windows_and_tabs - List all browser windows and tabs
  • chrome_navigate - Navigate to URLs and control viewport
  • chrome_close_tabs - Close specific tabs or windows
  • chrome_go_back_or_forward - Browser navigation control
  • chrome_inject_script - Inject content scripts into web pages
  • chrome_send_command_to_inject_script - Send commands to injected content scripts
πŸ“Έ Screenshots & Visual (1 tool)
  • chrome_screenshot - Advanced screenshot capture with element targeting, full-page support, and custom dimensions
🌐 Network Monitoring (4 tools)
  • chrome_network_capture_start/stop - webRequest API network capture
  • chrome_network_debugger_start/stop - Debugger API with response bodies
  • chrome_network_request - Send custom HTTP requests
πŸ” Content Analysis (4 tools)
  • search_tabs_content - AI-powered semantic search across browser tabs
  • chrome_get_web_content - Extract HTML/text content from pages
  • chrome_get_interactive_elements - Find clickable elements
  • chrome_console - Capture and retrieve console output from browser tabs
🎯 Interaction (3 tools)
  • chrome_click_element - Click elements using CSS selectors
  • chrome_fill_or_select - Fill forms and select options
  • chrome_keyboard - Simulate keyboard input and shortcuts
πŸ“š Data Management (5 tools)
  • chrome_history - Search browser history with time filters
  • chrome_bookmark_search - Find bookmarks by keywords
  • chrome_bookmark_add - Add new bookmarks with folder support
  • chrome_bookmark_delete - Delete bookmarks

πŸ§ͺ Usage Examples

AI helps you summarize webpage content and automatically control Excalidraw for drawing

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

https://github.com/user-attachments/assets/fd17209b-303d-48db-9e5e-3717141df183

After analyzing the content of the image, the LLM automatically controls Excalidraw to replicate the image

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

https://github.com/user-attachments/assets/60d12b1a-9b74-40f4-994c-95e8fa1fc8d3

AI automatically injects scripts and modifies webpage styles

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

https://github.com/user-attachments/assets/69cb561c-2e1e-4665-9411-4a3185f9643e

AI automatically captures network requests for you

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

https://github.com/user-attachments/assets/063f44ae-1754-46b6-b141-5988c86e4d96

AI helps analyze your browsing history

query: Analyze my browsing history from the past month

https://github.com/user-attachments/assets/e7a35118-e50e-4b1c-a790-0878aa2505ab

Web page conversation

query: Translate and summarize the current web page

https://github.com/user-attachments/assets/08aa86aa-7706-4df2-b400-576e2c7fcc7f

AI automatically takes screenshots for you (web page screenshots)

query: Take a screenshot of Hugging Face's homepage

https://github.com/user-attachments/assets/b081e41b-6309-40d6-885b-0da01691b12e

AI automatically takes screenshots for you (element screenshots)

query: Capture the icon from Hugging Face's homepage

https://github.com/user-attachments/assets/25657076-b84b-4459-a72f-90f896f06364

AI helps manage bookmarks

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

https://github.com/user-attachments/assets/73c1ea26-65fb-4b5e-b537-e32fa9bcfa52

Automatically close web pages

query: Close all shadcn-related web pages

https://github.com/user-attachments/assets/ff160f48-58e0-4c76-a6b0-c4e1f91370c8

🀝 Contributing

We welcome contributions! Please see for detailed guidelines.

🚧 Future Roadmap

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 and join our development community!

πŸ“„ License

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

πŸ“š More Documentation

  • - Detailed technical architecture documentation
  • - Complete tool API documentation
  • - Common issue solutions