Browsercat MCP Server

🚀 BrowserCat MCP Server

A Model Context Protocol server that leverages BrowserCat's cloud browser service to provide browser automation capabilities. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without installing a local browser.

✨ Features

Tools

• browsercat_navigate

  • Navigate the browser to any URL.
  • Input: url (string)

• browsercat_screenshot

  • Take a screenshot of a web page or a specific element.
  • Input:
    • name (string, required): Name of the screenshot.
    • selector (string, optional): CSS selector for the element to be captured.
    • width (number, optional, default: 800): Width of the screenshot.
    • height (number, optional, default: 600): Height of the screenshot.

• browsercat_click

  • Click on an element on the page.
  • Input: selector (string): CSS selector of the element to be clicked.

• browsercat_hover

  • Hover the mouse over an element on the page.
  • Input: selector (string): CSS selector of the element to be hovered over.

• browsercat_fill

  • Fill in a form field.
  • Input:
    • selector (string): CSS selector of the form field.
    • value (string): Value to be filled in.

• browsercat_select

  • Select an option from a dropdown menu.
  • Input:
    • selector (string): CSS selector of the dropdown element.
    • value (string): Value to be selected.

• browsercat_evaluate

  • Execute JavaScript in the browser console.
  • Input: script (string): JavaScript code to be executed.

Resources

The server provides the following two types of resources:

1. Console Logs (console://logs)

   • Text - formatted logs from the browser console.
   • Contains all console messages from the browser.

2. Screenshots (screenshot://<name>)

   • PNG image screenshots of the page.
   • Access a specific screenshot by its name.

🔧 Technical Details

• Cloud - based browser automation.
• No need to install a local browser.
• Console log monitoring.
• Screenshot functionality.
• JavaScript execution ability.
• Basic web page interactions (navigation, click, form filling).

📦 Installation

Environment Variables

The BrowserCat MCP server requires the following environment variables:

• BROWSERCAT_API_KEY: Your BrowserCat API key (required). You can get one for free at https://browsercat.xyz/mcp.

NPX Configuration

{
  "mcpServers": {
    "browsercat": {
      "command": "npx",
      "args": ["-y", "@browsercatco/mcp-server"],
      "env": {
        "BROWSERCAT_API_KEY": "your-api-key-here"
      }
    }
  }
}

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.