Firefox MCP Server

Advanced Firefox browser automation with comprehensive debugging capabilities

A powerful Model Context Protocol (MCP) server that provides sophisticated Firefox browser automation through 28 specialized tools. Designed for AI assistants and automation workflows requiring multi-session management, real-time debugging, and comprehensive web interaction capabilities.

🌟 Key Features

Multi-Session Architecture

• Isolated Browser Sessions: Each session runs in a completely separate context with independent cookies, storage, and debugging
• Perfect for Multiplayer Testing: Test multiplayer games and multi-user applications seamlessly
• Concurrent Operations: Manage multiple browser sessions simultaneously from a single interface

Comprehensive Debugging Suite

• Real-time Console Monitoring: Capture all console output (log, error, warn, info, debug)
• JavaScript Error Tracking: Monitor unhandled errors with full stack traces
• Network Activity Monitoring: Track HTTP requests, responses, and timing data
• WebSocket Traffic Capture: Perfect for Phoenix LiveView and real-time application debugging
• Performance Metrics: Monitor DOM timing, paint events, and memory usage

Advanced Interaction Capabilities

• Precise Element Interaction: Click, type, and interact with any web element
• Keyboard Event Simulation: Send complex key combinations and shortcuts
• Drag & Drop Operations: Smooth drag operations with customizable timing and steps
• JavaScript Execution: Run custom JavaScript in browser contexts

🚀 Quick Start

Installation

npm install firefox-mcp-server
npx playwright install firefox

Basic Usage

Add to your MCP client configuration:

{
  "mcpServers": {
    "firefox": {
      "command": "npx",
      "args": ["firefox-mcp-server"],
      "env": {}
    }
  }
}

Example: Multi-User Testing

// Launch browser and create isolated sessions
await browser_launch({headless: false})
await session_create({sessionId: "user1", url: "https://app.example.com"})
await session_create({sessionId: "user2", url: "https://app.example.com"})

// User 1 creates a game
await element_click({sessionId: "user1", selector: "button.create-game"})

// User 2 joins the game
await element_click({sessionId: "user2", selector: "button.join-game"})
await input_type({sessionId: "user2", selector: "input.game-code", text: "ABC123"})

// Monitor both sessions for real-time updates
await debug_websocket_messages({sessionId: "user1", limit: 10})
await debug_websocket_messages({sessionId: "user2", limit: 10})

🛠️ Complete Tool Reference

Browser Management

• browser_launch - Launch Firefox with debugging capabilities
• browser_close - Close browser and clean up all resources

Session Management

• session_create - Create isolated browser session with independent state
• session_list - List all active sessions with URLs and status
• session_close - Close specific session and free resources
• session_set_active - Set default session for subsequent operations

Page Navigation

• page_navigate - Navigate to any URL
• page_reload - Refresh current page
• history_back / history_forward - Browser history navigation
• url_get_current - Get current page URL

Element Interaction

• element_click - Click elements by selector or coordinates
• element_drag - Drag and drop with smooth animations
• input_type - Type text into input fields and text areas
• keyboard_press - Send keyboard events with modifier support
• element_wait - Wait for elements to appear or become visible

Content Extraction

• html_extract - Extract HTML content from page or elements
• text_extract - Get visible text content
• page_screenshot - Capture screenshots with flexible options

Advanced Capabilities

• javascript_execute - Run custom JavaScript in browser context

Comprehensive Debugging

... View full README on GitHub