mcp-firefox

An MCP (Model Context Protocol) server that connects to Firefox's Remote Debugging Protocol (RDP) over TCP, exposing browser DevTools capabilities as tools for LLMs.

How It Works

Firefox has a built-in Remote Debugging Protocol that speaks length-prefixed JSON over TCP. This server maintains a persistent connection to that port and translates MCP tool calls into RDP messages, returning the results to the LLM.

LLM ↔ MCP (HTTP :8090) ↔ Firefox RDP (TCP :6000)

The RDP client uses a background reader task to handle both request/response pairs and unsolicited events (like network traffic), enabling real-time capture features.

Related MCP server: ruyipage-mcp

Tools

Firefox Setup

1. Enable Remote Debugging

Open about:config in Firefox and set:

2. Start the Debug Listener

firefox --start-debugger-server 6000

This opens a TCP listener on localhost:6000. Your tabs and session restore normally.

3. Verify

ss -tlnp | grep 6000

You should see Firefox listening on 127.0.0.1:6000.

Installation

Requires Python 3.11+. Uses uv for dependency management:

uv venv
uv pip install -e .

Running

.venv/bin/firefox-mcp

The MCP server starts on http://0.0.0.0:8090/mcp using streamable HTTP transport (stateless mode).

Environment Variables

MCP Client Configuration

{
  "mcpServers": {
    "firefox-devtools": {
      "url": "http://localhost:8090/mcp"
    }
  }
}

Usage Examples

Page Content & Screenshots

# Read article text from a news site you're logged into
> read_page

# Take a screenshot of a specific element
> screenshot(selector=".article-body")

# Full page screenshot
> screenshot(fullpage=True)

Network Capture

Capture API traffic from web apps (streaming services, SPAs, etc.):

# Start recording network traffic
> start_capture

# Navigate to the app or trigger actions
> navigate("https://www.disneyplus.com/home")

# See what API calls were made
> read_capture

# Get response bodies (JSON payloads, manifests, etc.)
> read_capture(include_bodies=True)

# Done
> stop_capture

Raw RDP Exploration

> raw_rdp_command({"to": "root", "type": "listTabs"})
> raw_rdp_command({"to": "<consoleActor>", "type": "getCachedMessages", "messageTypes": ["PageError", "ConsoleAPI"]})

Use list_tabs first to discover actor IDs, then experiment with raw_rdp_command.