# ndthanhdev/mcp-browser-kit [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/ndthanhdev/mcp-browser-kit  
**GitHub Stars:** 54  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ndthanhdev-mcp-browser-kit

## Description
An MCP Server that enables AI assistants to interact with your local browsers.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-browser-kit": {
    "command": "npx",
    "args": ["-y","@mcp-browser-kit/server@latest"]
  }
}
```

## Documentation & README

# MCP Browser Kit

[![NPM Version](https://img.shields.io/npm/v/%40mcp-browser-kit%2Fserver)](https://www.npmjs.com/package/@mcp-browser-kit/server)
[![Firefox Add-on](https://img.shields.io/amo/v/mcp-browserkit-m2?logo=firefoxbrowser&logoColor=white&label=Firefox%20Add-on)](https://addons.mozilla.org/en-US/firefox/addon/mcp-browserkit-m2/)
[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/njoacgiflhkmfekmmpkeedgiipbaeagk?logo=googlechrome&logoColor=white&label=Chrome%20Web%20Store)](https://chromewebstore.google.com/detail/mcp-browser-kit-m3/njoacgiflhkmfekmmpkeedgiipbaeagk)
[![Workspace Updated](https://github.com/ndthanhdev/mcp-browser-kit/actions/workflows/workspace-updated.yml/badge.svg)](https://github.com/ndthanhdev/mcp-browser-kit/actions/workflows/workspace-updated.yml)
[![Checked with Biome](https://img.shields.io/badge/Checked_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev)
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/ndthanhdev/mcp-browser-kit)](https://archestra.ai/mcp-catalog/ndthanhdev__mcp-browser-kit)

[![mcp-browser-kit MCP server](https://glama.ai/mcp/servers/ndthanhdev/mcp-browser-kit/badges/card.svg)](https://glama.ai/mcp/servers/ndthanhdev/mcp-browser-kit)

> 🚀 **On the `main` branch?** You're viewing the bleeding-edge dev docs! For other versions, check out the `release/*` branches.

An MCP Server that enables AI assistants to interact with your local browsers.

https://github.com/user-attachments/assets/1fbf87fd-06d1-42bf-a06f-cc2bbdf375a8

## Usage

1. Add MCP Browser Kit to your MCP Client:

   ```json
   {
   	"mcpServers": {
   		"browser-kit": {
   			"command": "npx",
   			"args": ["@mcp-browser-kit/server@latest"]
   		}
   	}
   }
   ```
   By default the server use `stdio` transport, alternatively you can use `http` transport:

   ```bash
   npx @mcp-browser-kit/server@latest --transport http
   # optional flags (defaults shown):
   #   --http-host 127.0.0.1
   #   --http-port 21082
   ```

   Then point your MCP client at the URL instead of a `command`:

   ```json
   {
   	"mcpServers": {
   		"browser-kit": {
   			"url": "http://127.0.0.1:21082/mcp"
   		}
   	}
   }
   ```

   > **Security**: there's no auth yet, so `--http-host` defaults to
   > `127.0.0.1` (loopback only). Only pass `--http-host 0.0.0.0` (or a LAN
   > address) if you understand that anyone who can reach that host/port can
   > control your browser.

2. Choose the right extension build for your browser:

   - Check the [Compatibility table](#compatibility-table) below to see which build (M2 or M3) is compatible with your browser
   - Note that M2 builds offer more functionality than M3 builds, so prefer M2 if your browser supports both

3. Download the latest compatible build from [The Latest Release](https://github.com/ndthanhdev/mcp-browser-kit/releases/latest).

4. [Load the extension](#load-extension) into a compatible browser and enable it.

5. Refresh open tabs to ensure extension scripts are loaded.

6. Start messaging on your MCP Client:

   ```
   Use browser-kit, star the last open GitHub repo on my browser
   ```

7. Optional, check [User Notes](#user-notes) for more information.

## Compatibility table

> The M2 build supports more functionalities than the M3 build.
> Extension file name patterns:
> - M2 build:
>   - Chromium: `mcp_browser_kit_m2-<version>.zip` (e.g., `mcp_browser_kit_m2-5.0.0.zip`)
>   - Firefox: `mcp_browser_kit_m2-<version>.xpi` (e.g., `mcp_browser_kit_m2-5.0.0.xpi`)
> - M3 build: `mcp_browser_kit_m3-<version>.zip` (e.g., `mcp_browser_kit_m3-5.0.0.zip`)

| Browser | M2 build | M3 build |
| ------- | -------- | -------- |
| Chrome  | ❌       | ✅       |
| Brave   | ✅       | ✅       |
| Edge    | ✅       | ✅       |
| Firefox | ✅       | ❌       |
| Safari  | ✅       | ❌       |

## Load Extension

- Chromium-based browsers (Chrome, Brave, Edge)
  1.  Unzip the downloaded `.zip` file
  2.  Open [chrome://extensions/](https://github.com/ndthanhdev/mcp-browser-kit/blob/HEAD/chrome://extensions/)
  3.  Enable `Developer mode`
  4.  Click `Load unpacked`
  5.  Select the unpacked extension folder
- Firefox
  1.  Open [about:addons](https://github.com/ndthanhdev/mcp-browser-kit/blob/HEAD/about:addons)
  2.  Click the gear icon and select `Install Add-on From File`
  3.  Select the downloaded `.xpi` file
- Safari
  1.  Unzip the downloaded `.zip` file
  2.  Open `Develop > Show Extension Builder`
  3.  Click `+` and select `Add Extension`
  4.  Select the unpacked extension folder
  5.  Click `Install` to install the extension

# User Notes

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

> **Security**: BrowserKit currently lacks authentication for incoming requests. Keep ports 21082 and 2769-2799 on your device network only.

## Hosted deployment

A hosted deployment is available on [Fronteir AI](https://fronteir.ai/mcp/ndthanhdev-mcp-browser-kit).