Skip to main content

MuukTest Maintenance MCP

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

Requirements

  • Python 3.10+
  • uv

Configuration

VS Code / GitHub Copilot

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

{
  "inputs": [
    {
      "id": "muuk_key",
      "type": "promptString",
      "description": "Muuk Key available at MuukTest account",
      "password": true
    }
  ],
  "servers": {
    "muuk-maintenance": {
      "command": "uvx",
      "args": ["muuk-maintenance"],
      "env": {
        "MUUK_KEY": "${input:muuk_key}"
      }
    }
  }
}

Claude Desktop

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

{
  "mcpServers": {
    "muuk-maintenance": {
      "command": "uvx",
      "args": ["muuk-maintenance"],
      "env": {
        "MUUK_KEY": "your-api-key"
      }
    }
  }
}

Usage

Ask your AI agent:

Analyze the test failure in my project.
The test files are 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_files_path Path to test files directory
failure_data_path Path to failure data directory

Environment Variables

Variable Description
MUUK_KEY Your MuukTest key

Available AI Presets

  • claude (default)
  • openai
  • gemini

Troubleshooting

"The command uvx needed to run muuk-maintenance was not found"

VS Code can't find uvx in the PATH. Run in terminal:

which uvx

Then add the path to your shell profile (~/.zshrc or ~/.bashrc):

export PATH="$PATH:/path/from/which/uvx"

Restart VS Code after making changes.

Metadata

Release files for muuk-maintenance 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for muuk-maintenance 0.1.3
File Size Uploaded Provenance Actions
muuk_maintenance-0.1.3.tar.gz 5.9 kB Without provenance Details for muuk_maintenance-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for muuk-maintenance 0.1.3
File Interpreter ABI Platform Actions
muuk_maintenance-0.1.3-py3-none-any.whl Python 3 none any Details for muuk_maintenance-0.1.3-py3-none-any.whl

Total release size: 12.6 kB

Release files / muuk_maintenance-0.1.3.tar.gz

Download URL muuk_maintenance-0.1.3.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
58b33d6559852eb01a814c5bd21c0696a0c3d15a85ddee62ec9a92a2a9fef917
BLAKE2b-256 checksum
How to use checksums
629ff86df6dd7d619b717698e4edae0cee9ed75576a20ef204b3ad723e3dcf36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.1

Release files / muuk_maintenance-0.1.3-py3-none-any.whl

Download URL muuk_maintenance-0.1.3-py3-none-any.whl
Size 6.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5d585463835d692bfd411cf5136084aa221dfb5e997f2ee3d8fd4c1163418335
BLAKE2b-256 checksum
How to use checksums
15900a9c148f74933c92721401441669bc62289c82ac148ac492c71aa8bb2f15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.1

Security for muuk-maintenance 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page