https://github.com/ndthanhdev/mcp-browser-kit
An MCP Server that enables AI assistants to interact with your local browsers.
https://github.com/ndthanhdev/mcp-browser-kit
Last synced: about 2 months ago
JSON representation
An MCP Server that enables AI assistants to interact with your local browsers.
- Host: GitHub
- URL: https://github.com/ndthanhdev/mcp-browser-kit
- Owner: ndthanhdev
- Created: 2025-04-01T21:37:58.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-01-04T15:58:10.000Z (2 months ago)
- Last Synced: 2026-01-04T16:10:15.854Z (2 months ago)
- Language: TypeScript
- Homepage:
- Size: 2.21 MB
- Stars: 45
- Watchers: 1
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp - ndthanhdev/mcp-browser-kit
- awesome-mcp-servers - ndthanhdev/mcp-browser-kit - An MCP server for interacting with manifest v2 compatible browsers. ([Read more](/details/ndthanhdevmcp-browser-kit.md)) `mcp` `browser` `integration` `open-source` (API Integration MCP Servers)
- awesome-mcp-servers - ndthanhdev/mcp-browser-kit - manifest v2互換ブラウザとの相互作用のためのMCPサーバー (スター履歴 / 📂 <a name="browser-automation"></a>ブラウザ自動化)
- awesome-mcp-zh - ndthanhdev/mcp-browser-kit
- awesome-mcp-servers - ndthanhdev/mcp-browser-kit - manifest v2互換ブラウザとの相互作用のためのMCPサーバー (スター履歴 / 📂 <a name="browser-automation"></a>ブラウザ自動化)
- awesome-devops-mcp-servers - ndthanhdev/mcp-browser-kit - An MCP Server for interacting with manifest v2 compatible browsers. (CI/CD & DevOps Pipelines / 📂 Browser Automation)
- awesome-mcp-servers - **mcp-browser-kit** - An MCP Server that enables AI assistants to interact with your local browsers. `typescript` `mcp` `server` `ai` `local` `npm install ndthanhdev/mcp-browser-kit` (🌐 Web Development)
- awesome-mcp-security - ndthanhdev/mcp-browser-kit - An MCP Server for interacting with manifest v2 compatible browsers. (CI/CD & DevOps Pipelines / 📂 Browser Automation)
README
# MCP Browser Kit
[](https://www.npmjs.com/package/@mcp-browser-kit/server)
[](https://github.com/ndthanhdev/mcp-browser-kit/actions/workflows/ci.yml)
[](https://biomejs.dev)
[](https://archestra.ai/mcp-catalog/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"]
}
}
}
```
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-.zip` (e.g., `mcp_browser_kit_m2-5.0.0.zip`)
> - Firefox: `mcp_browser_kit_m2-.xpi` (e.g., `mcp_browser_kit_m2-5.0.0.xpi`)
> - M3 build: `mcp_browser_kit_m3-.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/](chrome://extensions/)
3. Enable `Developer mode`
4. Click `Load unpacked`
5. Select the unpacked extension folder
- Firefox
1. Open [about:addons](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 59089 and 2769-2799 on your device network only.