An MCP server that provides comprehensive browser automation and QA testing capabilities, integrating with desplega.ai for automated testing, session monitoring, batch test execution, and intelligent testing recommendations using AAA framework templates.

Installation

NPX (stdio)

npx @desplega.ai/qa-use-mcp

NPX (HTTP)

npx @desplega.ai/qa-use-mcp --http --port 3000

NPX (tunnel)

npx @desplega.ai/qa-use-mcp tunnel

Docker

FROM node:18-slim

# Install dependencies for Playwright
RUN apt-get update && apt-get install -y \
    libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 \
    libgbm1 libasound2 libxshmfence1 \
    && rm -rf /var/lib/apt/lists/*

# Install qa-use-mcp
RUN npm install -g @desplega.ai/qa-use-mcp

# Expose port
EXPOSE 3000

# Set API key via environment variable
ENV QA_USE_API_KEY=your-api-key-here

# Start in HTTP mode
CMD ["qa-use-mcp", "--http", "--port", "3000"]

Configuration

Standard MCP Client

{
  "mcpServers": {
    "desplega-qa": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use-mcp@latest"],
      "env": {
        "QA_USE_API_KEY": "your-desplega-ai-api-key"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "desplega-qa": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use-mcp@latest"],
      "env": {
        "QA_USE_API_KEY": "your-desplega-ai-api-key"
      }
    }
  }
}

Continue

{
  "mcpServers": {
    "desplega-qa": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use-mcp@latest"],
      "env": {
        "QA_USE_API_KEY": "your-desplega-ai-api-key"
      }
    }
  }
}

Zed

{
  "mcpServers": {
    "desplega-qa": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use-mcp@latest"],
      "env": {
        "QA_USE_API_KEY": "your-desplega-ai-api-key"
      }
    }
  }
}

Features

• Browser Management: Launch and control Playwright browser instances with headless/headed modes
• Tunneling: Create public tunnels for browser WebSocket endpoints using localtunnel
• API Integration: Full integration with desplega.ai API for comprehensive QA test workflows
• Session Management: Create, monitor, and control multiple QA test sessions with real-time status tracking
• Progress Monitoring: Real-time progress notifications with protection against MCP timeouts (maximum 25 seconds per call)
• Batch Test Execution: Run multiple automated tests simultaneously with dependency management
• Interactive Clarification: Intelligent prompts when remote sessions need user input to continue
• Test Discovery: Search and list automated tests with pagination and filtering
• Test Run Analytics: View test execution history with performance metrics and flakiness scores
• AAA Framework Templates: Ready-to-use templates for login, forms, e-commerce, navigation, and complex test scenarios

Environment Variables

Required

• QA_USE_API_KEY - Your desplega.ai API key for authentication

Optional

• QA_USE_REGION - Region for tunnel connections (e.g., 'us' for North America)

Usage Examples

Initialize the QA server and test the login form at https://app.example.com

Notes

The server supports three modes: stdio (default for MCP clients), HTTP/SSE (for web integrations), and tunnel (for backend-initiated tasks). Initial setup requires running init_qa_server with interactive=true or providing your desplega.ai API key. Sessions support up to 10 concurrent browser instances with a 30-minute TTL and automatic cleanup.