Ahtasham00/tactab

Tactile Browser Control & Multimodal Vision Bridge for AI Agents
**Tactab** (*Tactile + Tab*) is a high-performance, local, and open-source bridge that gives **any MCP-compliant AI client** (Cursor, Claude Desktop, Antigravity, Windsurf, Cline, etc.) live visual eyes and tactile hands in your **Google Chrome** browser using the **Model Context Protocol (MCP)**, **WebSockets**, and a **Chrome Extension (Manifest V3)**.
---
⚡ Highlights
- 🌐 **Works with Any Plan (Free or Paid):** Seamlessly connects whether you are on free tiers or paid Pro/Enterprise plans. Zero subscriptions or paid cloud automation platforms (like Browserbase or MultiOn) required.
- 👁️ **Visual Multimodal Vision & DOM Control:** Enables your AI to capture high-res PNG screenshots for visual layout inspection, alongside full DOM scraping, button clicks, form filling, and navigation.
- 🔒 **Private & 100% Local:** Operates strictly over local loopback (127.0.0.1). Your session cookies, authenticated tabs (AWS, Jira, GitHub), and local dev servers (localhost:3000) never leave your machine.
- 🧩 **Zero Extension Bloat (One Extension for All Agents):** Eliminates the need to install separate, heavy browser extensions for each AI tool. Tactab acts as a single, lightweight gateway that connects Claude, Cursor, Antigravity, or custom agents through standard MCP.
- 🔄 **Universal MCP Standard:** Plug-and-play with Claude Desktop, Cursor, Antigravity, Windsurf, or custom AI agents over standard I/O (stdio).
---
🏗️ Architecture
1. **AI Agent** invokes the automate_website tool over standard input/output (stdio).
2. **Tactab Bridge Server (bridge.js)** listens on 127.0.0.1:8765 and translates tool calls into JSON WebSocket messages.
3. **Tactab Chrome Extension Service Worker (background.js)** receives commands, manages connection status, and routes to active tabs.
4. **Content Script (content.js)** executes actions inside the active web page and returns structured results back up the pipeline.
---
📂 Project Structure
---
🚀 Quick Start Guide
1. Install Server Dependencies
Open your terminal in the server/ directory:
*(On Windows systems where script execution policies restrict npm, run npm.cmd install)*
---
2. Load the Chrome Extension
1. Open **Google Chrome** and navigate to chrome://extensions/.
2. Toggle on **Developer mode** in the top-right corner.
3. Click the **Load unpacked** button in the top-left corner.
4. Select the extension/ folder in this repository.
5. **Tactab — Browser MCP Bridge** will now appear in your extensions list.
- When connected to the local MCP server, the badge displays green **ON**.
- When disconnected, it displays red **OFF** and automatically retries every 5 seconds.
---
3. Configure Your AI Client
Add Tactab to your AI client's MCP configuration using your absolute path to server/bridge.js:
A. Claude Desktop
Config file location:
* **Windows**: %APPDATA%\Claude\claude_desktop_config.json
* **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
* **Linux**: ~/.config/Claude/claude_desktop_config.json
> **Windows Note:** Use escaped backslashes in paths, e.g.:
> "C:\\path\\to\\tactab\\server\\bridge.js"
B. Cursor IDE
Open **Cursor Settings** ➔ **Features** ➔ **MCP Servers** (or edit .cursor/mcp.json):
C. Antigravity / Windsurf / Cline
Add the exact same JSON block into your environment's MCP server configuration file.
---
🛠️ Supported Browser Actions
The automate_website tool supports the following actions on any standard webpage:
| Action | Required Payload | Optional Payload | Description |