Content
# Tabbit Browser MCP Server
The MCP (Model Context Protocol) Server for Tabbit Browser, enabling AI Agents to directly control Tabbit Browser's built-in Doubao AI for automated operations such as conversation, screenshot, device emulation, network management, and more.
## Features
- **AI Conversation** - Direct conversation with Tabbit's built-in Doubao AI, supporting multi-turn dialogue
- **Screenshot/PDF** - Viewport screenshot, full-page screenshot, element screenshot, PDF export
- **Device Emulation** - Simulate iPhone/Android/iPad/desktop viewport, supporting dark mode, geolocation
- **Network Management** - Cookie view/export/import, request interception, Mock response, URL blocking, network throttling
- **Storage Management** - Login state export/import, localStorage management, one-click clearing
- **Advanced Input** - Mouse click, keyboard input, shortcut keys, scrolling, dragging
- **Multi-Tab Management** - Parallel control of multiple tabs
- **Intelligent Navigation** - Automatic anti-detection injection, wind control waiting, automatic scrolling
- **Structured Extraction** - Structured data extraction of product lists, tables, links, images, etc.
- **Anti-Detection** - Automatic hiding of automation markers (webdriver/CDP detection)
- **Cookie Persistence** - Save/load/batch management of site cookies
## Installation
```bash
git clone https://github.com/southportns/tabbit-browser.git
cd tabbit-browser
npm install
```
## Prerequisites
1. Install [Tabbit Browser](https://www.tabbit.com/) (Chromium-based AI browser)
2. Launch Tabbit and enable debugging port:
```bash
# Windows
"D:\Tabbit Browser\Application\Tabbit Browser.exe" --remote-debugging-port=9222 --remote-allow-origins=* --enable-remote-debugging
```
Or use CLI to launch:
```bash
node cli.js launch
```
## MCP Configuration
### Claude Code / MiMoCode
Add to `~/.claude.json` in `mcpServers`:
```json
{
"mcpServers": {
"tabbit-browser": {
"command": "node",
"args": ["C:\\path\\to\\tabbit-browser\\mcp-server.js"],
"env": {
"TABBIT_PORT": "9222"
}
}
}
}
```
### Codex
Add to `~/.codex/config.toml`:
```toml
[mcp_servers.tabbit-browser]
command = "node"
args = ["/path/to/tabbit-browser/mcp-server.js"]
```
## Tool List
| Tool | Description |
|------|-------------|
| `tabbit_chat` | Send message to Tabbit AI and get response |
| `tabbit_screenshot` | Screenshot (viewport/full-page/element) |
| `tabbit_pdf` | Export page as PDF |
| `tabbit_device` | Device emulation (viewport/UA/dark mode/location) |
| `tabbit_network` | Network management (Cookie/interception/Mock/throttling) |
| `tabbit_storage` | Storage management (login state export/import) |
| `tabbit_input` | Advanced input (click/keyboard/drag) |
| `tabbit_tabs` | Multi-tab management |
| `tabbit_status` | Connection status |
| `tabbit_launch` | Launch Tabbit browser |
| `tabbit_new` | Open new conversation |
| `tabbit_navigate` | Intelligent navigation (automatic anti-detection + scrolling) |
| `tabbit_extract` | Structured data extraction (product/table/link/image) |
| `tabbit_antidetect` | Inject anti-detection script |
| `tabbit_cookies` | Cookie persistence (save/load/batch management) |
| `tabbit_status` | Check connection status |
| `tabbit_launch` | Launch Tabbit browser |
| `tabbit_new` | Open new conversation |
## CLI Usage
Besides MCP, you can also use the command line directly:
```bash
# Send message
node cli.js chat "Hello"
# Interactive conversation
node cli.js chat -i
# Device emulation
node cli.js device emulate iphone-14
node cli.js device dark on
node cli.js device reset
# Screenshot/PDF
node cli.js screenshot output.jpg
node cli.js screenshot --full
node cli.js pdf output.pdf
# Network management
node cli.js net cookies
node cli.js net export-cookies
node cli.js net block "ads.*"
node cli.js net throttle slow-3g
# Storage management
node cli.js storage export "https://web.tabbit.com"
node cli.js storage import login.json
# Multi-tab
node cli.js tabs
node cli.js tabs open "https://example.com"
# Batch conversation
node cli.js batch chat messages.json
```
## Supported Devices
| Device | Resolution | Type |
|------|------------|------|
| iPhone 14 | 390x844 | Mobile |
| iPhone 14 Pro Max | 430x932 | Mobile |
| iPad Pro | 1024x1366 | Mobile |
| Pixel 7 | 412x915 | Mobile |
| Galaxy S23 | 360x780 | Mobile |
| Desktop 1080p | 1920x1080 | Desktop |
| Desktop 1440p | 2560x1440 | Desktop |
## Tech Stack
- Node.js + Chrome DevTools Protocol (CDP)
- WebSocket communication
- No additional browser driver required (direct connection to Tabbit)
## License
MIT License
