muuk-test-repair-mcp 0.1.4

MCP server for analyzing and repairing E2E test failures

MuukTest Repair MCP

MCP server for analyzing and repairing E2E test failures (Playwright, Cypress, Selenium, etc).

Installation

pip install muuk-test-repair-mcp

Configuration

VS Code / GitHub Copilot

Open User MCP Configuration (Cmd+Shift+P → "MCP: Open User Configuration"):

{
  "inputs": [
    {
      "type": "promptString",
      "id": "muuk_api_key",
      "description": "MuukTest API Key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_access_key",
      "description": "AWS Access Key ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "aws_secret_key",
      "description": "AWS Secret Access Key",
      "password": true
    }
  ],
  "servers": {
    "muuk-test-repair": {
      "command": "muuk-test-repair-mcp",
      "env": {
        "MUUK_API_KEY": "${input:muuk_api_key}",
        "AWS_ACCESS_KEY_ID": "${input:aws_access_key}",
        "AWS_SECRET_ACCESS_KEY": "${input:aws_secret_key}"
      }
    }
  }
}

Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "muuk-test-repair": {
      "command": "muuk-test-repair-mcp",
      "env": {
        "MUUK_API_KEY": "your-api-key",
        "AWS_ACCESS_KEY_ID": "your-aws-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-aws-secret-key"
      }
    }
  }
}

Usage

Ask your AI agent:

Analyze the test failure in my project.
The test file is in ./test-files/ and failure data is in ./failure-data/

Required Parameters

Parameter	Description
workspace_path	Absolute path to project root (agent provides this automatically)
test_file_path	Path to test file or directory
failure_info_path	Path to failure info JSON
dom_elements_path	Path to DOM elements JSON
screenshot_path	Path to failure screenshot

Environment Variables

Variable	Description
MUUK_API_KEY	Your MuukTest API key
AWS_ACCESS_KEY_ID	AWS access key for API authentication
AWS_SECRET_ACCESS_KEY	AWS secret key for API authentication
AWS_REGION	AWS region (default: us-east-2)

Available AI Presets

• claude (default)
• openai
• gemini
• deepseek
• mistral

API Key

Request your credentials from MuukTest.

License

MIT