Skip to content
Back to search

mcp-chrome

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hangwin--mcp-chrome/badge.svg)](/listings/hangwin--mcp-chrome)

HTML

<a href="/listings/hangwin--mcp-chrome"><img src="/api/listings/hangwin--mcp-chrome/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Node.js >= 20.0.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

2. **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.

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

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

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:

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 305 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Chrome MCP Server πŸš€
  2. [![Stars](https://img.shields.io/github/stars/hangwin/mcp-chrome)](https://img.shields.io/github/stars/hangwin/mcp-chrome)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. [![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue.svg)](https://www.typescriptlang.org/)
  5. [![Chrome Extension](https://img.shields.io/badge/Chrome-Extension-green.svg)](https://developer.chrome.com/docs/extensions/)
  6. [![Release](https://img.shields.io/github/v/release/hangwin/mcp-chrome.svg)](https://img.shields.io/github/v/release/hangwin/mcp-chrome.svg)
  7. > 🌟 **Turn your Chrome browser into your intelligent assistant** - Let AI take control of your browser, transforming it into a powerful AI-controlled automation tool.
  8. **πŸ“– Documentation**: [English](README.md) | [δΈ­ζ–‡](README_zh.md)
  9. > The project is still in its early stages and is under intensive development. More features, stability improvements, and other enhancements will follow.
  10. ---
  11. ## 🎯 What is Chrome MCP Server?
  12. 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.
  13. ## ✨ New Features(2025/12/30)
  14. - **A New Visual Editor for Claude Code & Codex**, for more detail here: [VisualEditor](docs/VisualEditor.md)
  15. ## ✨ Core Features
  16. - 😁 **Chatbot/Model Agnostic**: Let any LLM or chatbot client or agent you prefer automate your browser
  17. - ⭐️ **Use Your Original Browser**: Seamlessly integrate with your existing browser environment (your configurations, login states, etc.)
  18. - πŸ’» **Fully Local**: Pure local MCP server ensuring user privacy
  19. - πŸš„ **Streamable HTTP**: Streamable HTTP connection method
  20. - 🏎 **Cross-Tab**: Cross-tab context
  21. - 🧠 **Semantic Search**: Built-in vector database for intelligent browser tab content discovery
  22. - πŸ” **Smart Content Analysis**: AI-powered text extraction and similarity matching
  23. - 🌐 **20+ Tools**: Support for screenshots, network monitoring, interactive operations, bookmark management, browsing history, and 20+ other tools
  24. - πŸš€ **SIMD-Accelerated AI**: Custom WebAssembly SIMD optimization for 4-8x faster vector operations
  25. ## πŸ†š Comparison with Similar Projects
  26. | Comparison Dimension | Playwright-based MCP Server | Chrome Extension-based MCP Server |
  27. | ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
  28. | **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 |
  29. | **User Session Reuse** | ❌ Requires re-login | βœ… Automatically uses existing login state |
  30. | **Browser Environment** | ❌ Clean environment lacks user settings | βœ… Fully preserves user environment |
  31. | **API Access** | ⚠️ Limited to Playwright API | βœ… Full access to Chrome native APIs |
  32. | **Startup Speed** | ❌ Requires launching browser process | βœ… Only needs to activate extension |
  33. | **Response Speed** | 50-200ms inter-process communication | βœ… Faster |
  34. ## πŸš€ Quick Start
  35. ### Prerequisites
  36. - Node.js >= 20.0.0 and pnpm/npm
  37. - Chrome/Chromium browser
  38. ### Installation Steps
  39. 1. **Download the latest Chrome extension from GitHub**
  40. Download link: https://github.com/hangwin/mcp-chrome/releases
  41. 2. **Install mcp-chrome-bridge globally**
  42. npm
  43. ```bash
  44. npm install -g mcp-chrome-bridge
  45. ```
  46. pnpm
  47. ```bash
  48. # Method 1: Enable scripts globally (recommended)
  49. pnpm config set enable-pre-post-scripts true
  50. pnpm install -g mcp-chrome-bridge
  51. # Method 2: Manual registration (if postinstall doesn't run)
  52. pnpm install -g mcp-chrome-bridge
  53. mcp-chrome-bridge register
  54. ```
  55. > 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.
  56. 3. **Load Chrome Extension**
  57. - Open Chrome and go to `chrome://extensions/`
  58. - Enable "Developer mode"
  59. - Click "Load unpacked" and select `your/dowloaded/extension/folder`
  60. - Click the extension icon to open the plugin, then click connect to see the MCP configuration
  61. <img width="475" alt="Screenshot 2025-06-09 15 52 06" src="https://github.com/user-attachments/assets/241e57b8-c55f-41a4-9188-0367293dc5bc" />
  62. ### Usage with MCP Protocol Clients
  63. #### Using Streamable HTTP Connection (πŸ‘πŸ» Recommended)
  64. Add the following configuration to your MCP client configuration (using CherryStudio as an example):
  65. > Streamable HTTP connection method is recommended
  66. ```json
  67. {
  68. "mcpServers": {
  69. "chrome-mcp-server": {
  70. "type": "streamableHttp",
  71. "url": "http://127.0.0.1:12306/mcp"
  72. }
  73. }
  74. }
  75. ```
  76. #### Using STDIO Connection (Alternative)
  77. If your client only supports stdio connection method, please use the following approach:
  78. 1. First, check the installation location of the npm package you just installed
  79. ```sh
  80. # npm check method
  81. npm list -g mcp-chrome-bridge
  82. # pnpm check method
  83. pnpm list -g mcp-chrome-bridge
  84. ```
  85. Assuming the command above outputs the path: /Users/xxx/Library/pnpm/global/5
  86. Then your final path would be: /Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js
  87. 2. Replace the configuration below with the final path you just obtained
  88. ```json
  89. {
  90. "mcpServers": {
  91. "chrome-mcp-stdio": {
  92. "command": "npx",
  93. "args": [
  94. "node",
  95. "/Users/xxx/Library/pnpm/global/5/node_modules/mcp-chrome-bridge/dist/mcp/mcp-server-stdio.js"
  96. ]
  97. }
  98. }
  99. }
  100. ```
  101. eg:config in augment:
  102. <img width="494" alt="ζˆͺ屏2025-06-22 22 11 25" src="https://github.com/user-attachments/assets/48eefc0c-a257-4d3b-8bbe-d7ff716de2bf" />
  103. ## πŸ› οΈ Available Tools
  104. Complete tool list: [Complete Tool List](docs/TOOLS.md)
  105. <details>
  106. <summary><strong>πŸ“Š Browser Management (6 tools)</strong></summary>
  107. - `get_windows_and_tabs` - List all browser windows and tabs
  108. - `chrome_navigate` - Navigate to URLs and control viewport
  109. - `chrome_switch_tab` - Switch the current active tab
  110. - `chrome_close_tabs` - Close specific tabs or windows
  111. - `chrome_go_back_or_forward` - Browser navigation control
  112. - `chrome_inject_script` - Inject content scripts into web pages
  113. - `chrome_send_command_to_inject_script` - Send commands to injected content scripts
  114. </details>
  115. <details>
  116. <summary><strong>πŸ“Έ Screenshots & Visual (1 tool)</strong></summary>
  117. - `chrome_screenshot` - Advanced screenshot capture with element targeting, full-page support, and custom dimensions
  118. </details>
  119. <details>
  120. <summary><strong>🌐 Network Monitoring (4 tools)</strong></summary>
  121. - `chrome_network_capture_start/stop` - webRequest API network capture
  122. - `chrome_network_debugger_start/stop` - Debugger API with response bodies
  123. - `chrome_network_request` - Send custom HTTP requests
  124. </details>
  125. <details>
  126. <summary><strong>πŸ” Content Analysis (4 tools)</strong></summary>
  127. - `search_tabs_content` - AI-powered semantic search across browser tabs
  128. - `chrome_get_web_content` - Extract HTML/text content from pages
  129. - `chrome_get_interactive_elements` - Find clickable elements
  130. - `chrome_console` - Capture and retrieve console output from browser tabs
  131. </details>
  132. <details>
  133. <summary><strong>🎯 Interaction (3 tools)</strong></summary>
  134. - `chrome_click_element` - Click elements using CSS selectors
  135. - `chrome_fill_or_select` - Fill forms and select options
  136. - `chrome_keyboard` - Simulate keyboard input and shortcuts
  137. </details>
  138. <details>
  139. <summary><strong>πŸ“š Data Management (5 tools)</strong></summary>
  140. - `chrome_history` - Search browser history with time filters
  141. - `chrome_bookmark_search` - Find bookmarks by keywords
  142. - `chrome_bookmark_add` - Add new bookmarks with folder support
  143. - `chrome_bookmark_delete` - Delete bookmarks
  144. </details>
  145. ## πŸ§ͺ Usage Examples
  146. ### AI helps you summarize webpage content and automatically control Excalidraw for drawing
  147. prompt: [excalidraw-prompt](prompt/excalidraw-prompt.md)
  148. Instruction: Help me summarize the current page content, then draw a diagram to aid my understanding.
  149. https://www.youtube.com/watch?v=3fBPdUBWVz0
  150. https://github.com/user-attachments/assets/fd17209b-303d-48db-9e5e-3717141df183
  151. ### After analyzing the content of the image, the LLM automatically controls Excalidraw to replicate the image
  152. prompt: [excalidraw-prompt](prompt/excalidraw-prompt.md)|[content-analize](prompt/content-analize.md)
  153. Instruction: First, analyze the content of the image, and then replicate the image by combining the analysis with the content of the image.
  154. https://www.youtube.com/watch?v=tEPdHZBzbZk
  155. https://github.com/user-attachments/assets/60d12b1a-9b74-40f4-994c-95e8fa1fc8d3
  156. ### AI automatically injects scripts and modifies webpage styles
  157. prompt: [modify-web-prompt](prompt/modify-web.md)
  158. Instruction: Help me modify the current page's style and remove advertisements.
  159. https://youtu.be/twI6apRKHsk
  160. https://github.com/user-attachments/assets/69cb561c-2e1e-4665-9411-4a3185f9643e
  161. ### AI automatically captures network requests for you
  162. query: I want to know what the search API for Xiaohongshu is and what the response structure looks like
  163. https://youtu.be/1hHKr7XKqnQ
  164. https://github.com/user-attachments/assets/dc7e5cab-b9af-4b9a-97ce-18e4837318d9
  165. ### AI helps analyze your browsing history
  166. query: Analyze my browsing history from the past month
  167. https://youtu.be/jf2UZfrR2Vk
  168. https://github.com/user-attachments/assets/31b2e064-88c6-4adb-96d7-50748b826eae
  169. ### Web page conversation
  170. query: Translate and summarize the current web page
  171. https://youtu.be/FlJKS9UQyC8
  172. https://github.com/user-attachments/assets/aa8ef2a1-2310-47e6-897a-769d85489396
  173. ### AI automatically takes screenshots for you (web page screenshots)
  174. query: Take a screenshot of Hugging Face's homepage
  175. https://youtu.be/7ycK6iksWi4
  176. https://github.com/user-attachments/assets/65c6eee2-6366-493d-a3bd-2b27529ff5b3
  177. ### AI automatically takes screenshots for you (element screenshots)
  178. query: Capture the icon from Hugging Face's homepage
  179. https://youtu.be/ev8VivANIrk
  180. https://github.com/user-attachments/assets/d0cf9785-c2fe-4729-a3c5-7f2b8b96fe0c
  181. ### AI helps manage bookmarks
  182. query: Add the current page to bookmarks and put it in an appropriate folder
  183. https://youtu.be/R_83arKmFTo
  184. https://github.com/user-attachments/assets/15a7d04c-0196-4b40-84c2-bafb5c26dfe0
  185. ### Automatically close web pages
  186. query: Close all shadcn-related web pages
  187. https://youtu.be/2wzUT6eNVg4
  188. https://github.com/user-attachments/assets/83de4008-bb7e-494d-9b0f-98325cfea592
  189. ## 🀝 Contributing
  190. We welcome contributions! Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for detailed guidelines.
  191. ## 🚧 Future Roadmap
  192. We have exciting plans for the future development of Chrome MCP Server:
  193. - [ ] Authentication
  194. - [ ] Recording and Playback
  195. - [ ] Workflow Automation
  196. - [ ] Enhanced Browser Support (Firefox Extension)
  197. ---
  198. **Want to contribute to any of these features?** Check out our [Contributing Guide](docs/CONTRIBUTING.md) and join our development community!
  199. ## πŸ“„ License
  200. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  201. ## πŸ“š More Documentation
  202. - [Architecture Design](docs/ARCHITECTURE.md) - Detailed technical architecture documentation
  203. - [TOOLS API](docs/TOOLS.md) - Complete tool API documentation
  204. - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issue solutions

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.