Vibe MCP - Browser Automation for AI Agents

MCP server for Vibe AI Browser - the only browser automation tool that supports multiple AI agents simultaneously.

Why Vibe MCP?

Feature	Vibe MCP	Playwright MCP	BrowserMCP
Multi-Agent Support	Yes	No	No
Uses Your Browser Profile	Yes	No	No
Logged-In Sessions	Yes	No	No
No Separate Browser	Yes	No	No
Local & Private	Yes	Yes	Partial
Content Script Based	Yes	No	No

Multi-Agent Architecture

Vibe MCP is the only solution that allows multiple AI agents to control the same browser simultaneously. Run Claude Desktop, Cursor, VS Code Copilot, and OpenCode all at once - they all share control of your browser through our relay architecture.

Claude Desktop       Cursor          VS Code         OpenCode
     |                  |                |               |
     v                  v                v               v
 [vibe-mcp]        [vibe-mcp]       [vibe-mcp]      [vibe-mcp]
     |                  |                |               |
     +------------------+----------------+---------------+
                        |
                        v
                  [Relay Daemon]  <-- Auto-spawned, handles multiplexing
                        |
                        v
                 [Vibe Extension]
                        |
                        v
                   [Your Chrome]

Competitors like Playwright MCP and BrowserMCP fail when you try to run multiple agents - they get port conflicts or connection errors. Vibe MCP just works.

Features

Multi-Agent Ready - Run Claude, Cursor, VS Code, and more simultaneously
Uses Your Browser - No separate browser instance, uses your existing Chrome with all your logins
Fast & Local - Automation happens on your machine, no cloud latency
Private - Your browsing data never leaves your device
Stable - Content script based, no flaky CDP connections

Quick Start

1. Install the Vibe Extension

Install the Vibe AI Browser extension in Chrome, Brave, or any Chromium browser:

Option A: Chrome Web Store (Recommended)

Visit the Chrome Web Store
Click "Add to Chrome"
The Vibe icon will appear in your toolbar

Option B: Developer Version

Download the latest release ZIP
Extract to a permanent folder
Go to chrome://extensions, enable Developer Mode
Click "Load unpacked" and select the extracted folder

For detailed instructions, see the installation guide.

2. Configure Your AI Application

Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Open Cursor Settings (Cmd/Ctrl + ,)
Go to "Features" -> "MCP Servers"
Click "Add Server" and add:

{
  "vibe": {
    "command": "npx",
    "args": ["-y", "@vibebrowser/mcp"]
  }
}

Or edit ~/.cursor/mcp.json directly.

VS Code (GitHub Copilot)

Add to your VS Code settings.json:

{
  "github.copilot.chat.mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

OpenCode

Add to your .opencode/config.json:

{
  "mcp": {
    "servers": {
      "vibe": {
        "command": "npx",
        "args": ["-y", "@vibebrowser/mcp"]
      }
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

OpenAI Codex CLI

Add to your Codex configuration:

{
  "mcp": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

3. Connect the Extension

Open Chrome with the Vibe extension installed
Click the Vibe extension icon in the toolbar
Go to Settings and enable "MCP External Control"
The status should show "Connected"

Available Tools

Tool	Description
`navigate_to_url`	Navigate to any URL
`go_back` / `go_forward`	Browser history navigation
`click`	Click elements on the page
`type` / `fill`	Enter text into inputs
`scroll`	Scroll the page
`take_screenshot`	Capture screenshots
`get_page_content`	Extract page text/HTML
`get_tabs` / `create_new_tab` / `switch_to_tab` / `close_tab`	Tab management
`keyboard_shortcut`	Press keyboard combinations
`web_search`	Search the web

How It Works

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│ AI Application  │────>│  Vibe MCP       │────>│ Vibe Extension  │
│ (Claude/Cursor) │stdio│  (this package) │ WS  │ (Chrome)        │
└─────────────────┘     └─────────────────┘     └─────────────────┘

AI applications connect via MCP protocol (stdio)
Vibe MCP forwards commands to the browser extension via WebSocket
The extension executes actions in your actual browser
Results flow back to the AI

Multi-Agent Mode

When multiple agents connect, Vibe MCP automatically spawns a relay daemon:

First agent starts the relay (listens on ports 19988 and 19989)
Additional agents connect to the relay as clients
Relay multiplexes all agent requests to the single extension connection
Each agent receives only its own responses

CLI Options

npx @vibebrowser/mcp --help

Options:
  -p, --port <number>  WebSocket port for extension (default: 19989)
  -d, --debug          Enable debug logging
  -h, --help           Show help

Troubleshooting

"No connection to Vibe extension"

Ensure the Vibe extension is installed in Chrome
Click the extension icon and enable "MCP External Control" in Settings
Check that no firewall is blocking localhost connections

Debug mode

Enable debug logging to diagnose issues:

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp", "--debug"]
    }
  }
}

Development

git clone https://github.com/VibeTechnologies/vibe-mcp.git
cd vibe-mcp
npm install
npm run build
node dist/cli.js --debug

Keywords

browser automation, mcp server, model context protocol, ai browser control, claude desktop browser, cursor browser automation, web automation, chrome automation, ai agent browser, multi-agent browser control, playwright alternative, puppeteer alternative, browser mcp, web scraping ai, ai web agent

License

Apache-2.0

@vibebrowser/mcp

Quick Install