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.
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
| Comparison Dimension | Playwright-based MCP Server | Chrome 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 Speed | 50-200ms inter-process communication | ✅ Faster |
🚀 Quick Start
Prerequisites
- Node.js >= 18.19.0 and pnpm/npm
- Chrome/Chromium browser
Installation Steps
- Download the latest Chrome extension from GitHub
Download link: https://github.com/hangwin/mcp-chrome/releases
- Install mcp-chrome-bridger globally
npm
npm install -g mcp-chrome-bridger
pnpm
# Method 1: Enable scripts globally (recommended)
pnpm config set enable-pre-post-scripts true
pnpm install -g mcp-chrome-bridger
# Method 2: Manual registration (if postinstall doesn't run)
pnpm install -g mcp-chrome-bridger
mcp-chrome-bridger register
Note: pnpm v7+ disables postinstall scripts by default for security. The
enable-pre-post-scriptssetting controls whether pre/post install scripts run. If automatic registration fails, use the manual registration command above.
- 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
- Open Chrome and go to
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:
- First, check the installation location of the npm package you just installed
# npm check method
npm list -g mcp-chrome-bridger
# pnpm check method
pnpm list -g mcp-chrome-bridger
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-bridger/dist/mcp/mcp-server-stdio.js
- 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-bridger/dist/mcp/mcp-server-stdio.js"
]
}
}
}
eg：config in augment:
🛠️ Available Tools
Complete tool list: Complete Tool List
📊 Browser Management (6 tools)
get_windows_and_tabs- List all browser windows and tabschrome_navigate- Navigate to URLs and control viewportchrome_switch_tab- Switch the current active tabchrome_close_tabs- Close specific tabs or windowschrome_go_back_or_forward- Browser navigation controlchrome_inject_script- Inject content scripts into web pageschrome_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 capturechrome_network_debugger_start/stop- Debugger API with response bodieschrome_network_request- Send custom HTTP requests
🔍 Content Analysis (4 tools)
search_tabs_content- AI-powered semantic search across browser tabschrome_get_web_content- Extract HTML/text content from pageschrome_get_interactive_elements- Find clickable elementschrome_console- Capture and retrieve console output from browser tabs
🎯 Interaction (3 tools)
chrome_click_element- Click elements using CSS selectorschrome_fill_or_select- Fill forms and select optionschrome_keyboard- Simulate keyboard input and shortcuts
📚 Data Management (5 tools)
chrome_history- Search browser history with time filterschrome_bookmark_search- Find bookmarks by keywordschrome_bookmark_add- Add new bookmarks with folder supportchrome_bookmark_delete- Delete bookmarks
🧪 Usage Examples
AI helps you summarize webpage content and automatically control Excalidraw for drawing
prompt: excalidraw-prompt Instruction: Help me summarize the current page content, then draw a diagram to aid my understanding. https://www.youtube.com/watch?v=3fBPdUBWVz0
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: 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. https://www.youtube.com/watch?v=tEPdHZBzbZk
https://github.com/user-attachments/assets/60d12b1a-9b74-40f4-994c-95e8fa1fc8d3
AI automatically injects scripts and modifies webpage styles
prompt: modify-web-prompt Instruction: Help me modify the current page's style and remove advertisements. https://youtu.be/twI6apRKHsk
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/dc7e5cab-b9af-4b9a-97ce-18e4837318d9
AI helps analyze your browsing history
query: Analyze my browsing history from the past month
https://github.com/user-attachments/assets/31b2e064-88c6-4adb-96d7-50748b826eae
Web page conversation
query: Translate and summarize the current web page https://youtu.be/FlJKS9UQyC8
https://github.com/user-attachments/assets/aa8ef2a1-2310-47e6-897a-769d85489396
AI automatically takes screenshots for you (web page screenshots)
query: Take a screenshot of Hugging Face's homepage https://youtu.be/7ycK6iksWi4
https://github.com/user-attachments/assets/65c6eee2-6366-493d-a3bd-2b27529ff5b3
AI automatically takes screenshots for you (element screenshots)
query: Capture the icon from Hugging Face's homepage https://youtu.be/ev8VivANIrk
https://github.com/user-attachments/assets/d0cf9785-c2fe-4729-a3c5-7f2b8b96fe0c
AI helps manage bookmarks
query: Add the current page to bookmarks and put it in an appropriate folder
https://github.com/user-attachments/assets/15a7d04c-0196-4b40-84c2-bafb5c26dfe0
Automatically close web pages
query: Close all shadcn-related web pages
https://github.com/user-attachments/assets/83de4008-bb7e-494d-9b0f-98325cfea592
🤝 Contributing
We welcome contributions! Please see CONTRIBUTING.md 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 Contributing Guide and join our development community!
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
📚 More Documentation
- Architecture Design - Detailed technical architecture documentation
- TOOLS API - Complete tool API documentation
- Troubleshooting - Common issue solutions
based on https://github.com/hangwin/mcp-chrome and fixed a few bugs.