MCP

🚀 Browser MCP Server

A Model Context Protocol (MCP) server that leverages Anchor Browser's remote browser service with Playwright to offer browser automation capabilities. This server empowers LLMs to interact with web pages via Anchor's cloud-based browsers, which come with built-in proxies, stealth features, and advanced capabilities.

🚀 Quick Start

1. Clone and Build

As this is a custom Browser MCP server, you need to build it locally:

# Clone the repository
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# Install dependencies and build
npm install
npm run build

2. Get Your Anchor API Key

1. Sign up at anchorbrowser.io.
2. Retrieve your API key from the dashboard.
3. Copy your API key (it starts with sk-).

3. Configure MCP Client

Cursor

Add the following to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

VS Code

Add the following to your MCP configuration:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

4. Restart Your MCP Client

After updating the configuration, restart your MCP client (such as Cursor or VS Code) to load the new server.

✨ Features

• Remote Browser Execution: Utilizes Anchor Browser's cloud infrastructure instead of local browsers.
• Built-in Proxies: Automatically rotates residential proxies and supports geo-targeting.
• Stealth & Anti-Detection: Employs advanced browser fingerprinting and anti-bot detection techniques.
• Fast and lightweight: Uses Playwright's accessibility tree instead of pixel-based input.
• LLM-friendly: Does not require vision models and operates solely on structured data.
• Deterministic tool application: Avoids the ambiguity common in screenshot-based approaches.

📦 Installation

• Node.js 18 or newer.
• Anchor Browser API Key (Get one here).
• VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client.

💻 Usage Examples

Basic Usage

The following steps show how to set up and run the Browser MCP server:

# Clone the repository
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# Install dependencies and build
npm install
npm run build

Advanced Usage

Configuration Options

The Browser MCP server supports only essential configuration options:

node cli.js --help

Available Options:

• --host <host> - Host to bind the server to (default: localhost, use 0.0.0.0 for all interfaces).
• --port <port> - Port to listen on for HTTP transport (Docker/server mode).

Example with Options:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js",
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

HTTP Server Mode (Docker):

For Docker or headless server environments:

# Run as HTTP server
ANCHOR_API_KEY="sk-your-key" node cli.js --port 8931 --host 0.0.0.0

Then configure your MCP client to use the HTTP endpoint:

{
  "mcpServers": {
    "anchor-browser": {
      "url": "http://localhost:8931/mcp"
    }
  }
}

📚 Documentation

How It Works

1. Browser Session Creation: When you use browser tools, the MCP server calls Anchor's API to create a remote browser session.
2. Remote Connection: Connects to the remote browser via WebSocket using Chrome DevTools Protocol (CDP).
3. Tool Execution: All browser automation occurs in Anchor's cloud infrastructure.
4. Proxy & Stealth: Automatically rotates residential proxies and features advanced anti-detection capabilities.
5. Session Management: Each session is isolated and can be viewed live via Anchor's dashboard.

Benefits Over Local Browsers

🌐 Global Proxy Network

• Automatically rotates residential proxies.
• Supports geo-targeting for different regions.
• Eliminates the need for proxy configuration.

🛡️ Advanced Stealth

• Protects against browser fingerprinting.
• Bypasses anti-bot detection.
• Employs real browser environments.

☁️ Cloud Infrastructure

• Eliminates local browser dependencies.
• Ensures consistent browser versions.
• Supports scalable execution.

📊 Monitoring & Debugging

• Provides a live view of browser sessions.
• Records sessions and traces.
• Logs network requests.

Available Tools

The Browser MCP server provides all standard browser automation tools:

Core Automation

• anchor_navigate - Navigate to URLs.
• anchor_click - Click elements.
• browser_type - Type text into inputs.
• browser_snapshot - Get the page accessibility tree.
• browser_take_screenshot - Take screenshots.
• browser_evaluate - Execute JavaScript.
• browser_wait_for - Wait for conditions.

Tab Management

• browser_tab_new - Open new tabs.
• browser_tab_list - List open tabs.
• browser_tab_select - Switch between tabs.
• browser_tab_close - Close tabs.

Advanced Features

• browser_file_upload - Upload files.
• browser_handle_dialog - Handle alerts/confirms.
• browser_network_requests - View network traffic.
• browser_pdf_save - Generate PDFs (with --caps=pdf).

Troubleshooting

Invalid API Key

Error: Missing ANCHOR_API_KEY environment variable

Solution: Ensure your API key is correctly set in the MCP configuration.

Build Errors

npm run build

Solution: Make sure you have Node.js 18+ and run npm install first.

Connection Issues

Check the MCP logs for Anchor API responses and WebSocket connection status.

Session Limits

Each Anchor API key has session limits. Check your dashboard at anchorbrowser.io for usage.

Development

To modify or extend the Browser MCP server:

# Make changes to TypeScript files in src/
# Then rebuild
npm run build

# Test your changes
node cli.js --help

The server will automatically use Anchor's remote browsers for all operations, providing the benefits of cloud-based browser automation with advanced proxy and stealth capabilities.

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Support

• Anchor Browser: anchorbrowser.io
• Documentation: Anchor Browser Docs
• MCP Protocol: Model Context Protocol