MCP Browser Kit

1# MCP Browser Kit
2 
3[![NPM Version](https://img.shields.io/npm/v/%40mcp-browser-kit%2Fserver)](https://www.npmjs.com/package/@mcp-browser-kit/server)
4[![CI Workflow](https://github.com/ndthanhdev/mcp-browser-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/ndthanhdev/mcp-browser-kit/actions/workflows/ci.yml)
5[![Checked with Biome](https://img.shields.io/badge/Checked_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev)
6[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/ndthanhdev/mcp-browser-kit)](https://archestra.ai/mcp-catalog/ndthanhdev__mcp-browser-kit)
7 
8> 🚀 **On the `main` branch?** You're viewing the bleeding-edge dev docs! For other versions, check out the `release/*` branches.
9 
10An MCP Server that enables AI assistants to interact with your local browsers.
11 
12https://github.com/user-attachments/assets/1fbf87fd-06d1-42bf-a06f-cc2bbdf375a8
13 
14## Usage
15 
161. Add MCP Browser Kit to your MCP Client:
17 
18   ```json
19   {
20   	"mcpServers": {
21   		"browser-kit": {
22   			"command": "npx",
23   			"args": ["@mcp-browser-kit/server@latest"]
24   		}
25   	}
26   }
27   ```
28 
292. Choose the right extension build for your browser:
30 
31   - Check the [Compatibility table](#compatibility-table) below to see which build (M2 or M3) is compatible with your browser
32   - Note that M2 builds offer more functionality than M3 builds, so prefer M2 if your browser supports both
33 
343. Download the latest compatible build from [The Latest Release](https://github.com/ndthanhdev/mcp-browser-kit/releases/latest).
35 
364. [Load the extension](#load-extension) into a compatible browser and enable it.
37 
385. Refresh open tabs to ensure extension scripts are loaded.
39 
406. Start messaging on your MCP Client:
41 
42   ```
43   Use browser-kit, star the last open GitHub repo on my browser
44   ```
45 
467. Optional, check [User Notes](#user-notes) for more information.
47 
48## Compatibility table
49 
50> The M2 build supports more functionalities than the M3 build.
51> Extension file name patterns:
52> - M2 build:
53>   - Chromium: `mcp_browser_kit_m2-<version>.zip` (e.g., `mcp_browser_kit_m2-5.0.0.zip`)
54>   - Firefox: `mcp_browser_kit_m2-<version>.xpi` (e.g., `mcp_browser_kit_m2-5.0.0.xpi`)
55> - M3 build: `mcp_browser_kit_m3-<version>.zip` (e.g., `mcp_browser_kit_m3-5.0.0.zip`)
56 
57| Browser | M2 build | M3 build |
58| ------- | -------- | -------- |
59| Chrome  | ❌       | ✅       |
60| Brave   | ✅       | ✅       |
61| Edge    | ✅       | ✅       |
62| Firefox | ✅       | ❌       |
63| Safari  | ✅       | ❌       |
64 
65## Load Extension
66 
67- Chromium-based browsers (Chrome, Brave, Edge)
68  1.  Unzip the downloaded `.zip` file
69  2.  Open [chrome://extensions/](chrome://extensions/)
70  3.  Enable `Developer mode`
71  4.  Click `Load unpacked`
72  5.  Select the unpacked extension folder
73- Firefox
74  1.  Open [about:addons](about:addons)
75  2.  Click the gear icon and select `Install Add-on From File`
76  3.  Select the downloaded `.xpi` file
77- Safari
78  1.  Unzip the downloaded `.zip` file
79  2.  Open `Develop > Show Extension Builder`
80  3.  Click `+` and select `Add Extension`
81  4.  Select the unpacked extension folder
82  5.  Click `Install` to install the extension
83 
84# User Notes
85 
86> **Note for Alpha stage**: Consider using a separate browser profile or dedicated browser instance with this MCP to prevent sensitive data from being unintentionally exposed to AI model providers.
87 
88> **Security**: BrowserKit currently lacks authentication for incoming requests. Keep ports 59089 and 2769-2799 on your device network only.
89