@assert-click/mcp

MCP-Server für Assert — ermöglicht es Ihrem KI-Coding-Agenten, E2E-Tests zu generieren, auszuführen und zu überprüfen, ohne den Chat zu verlassen.

Beschreiben Sie einen Benutzerablauf in einfachem Englisch. Assert generiert einen Playwright-Test, führt ihn in einem echten Browser aus und liefert schrittweise Ergebnisse sowie Screenshots bei Fehlern — alles über einen einzigen Tool-Aufruf in Cursor, Claude, Windsurf oder jedem anderen MCP-kompatiblen Agenten.

Registrieren Sie sich kostenlos unter assert.click, um Ihren API-Schlüssel und Ihre Projekt-ID zu erhalten, bevor Sie dieses Paket verwenden.

Was Ihr Agent tun kann

• Generieren — beschreiben Sie einen Ablauf und erhalten Sie ein Markdown-Szenario, das bereit zum Speichern und Ausführen ist

• Ausführen — führen Sie ein gespeichertes Szenario oder ein Ad-hoc-Markdown in einem echten Chromium-Browser aus

• Überprüfen — rufen Sie schrittweise Erfolgs-/Fehlermeldungen und URLs zu Screenshots bei Fehlern ab

• Auflisten — durchsuchen Sie gespeicherte Szenarien für das Projekt

Anforderungen

• Node.js >=18.17

• Ein Assert-Schlüssel mit Projektbezug — erhalten Sie einen unter assert.click

Einrichtung

1. Erstellen Sie assert.config.json in Ihrem Repository:

{
  "projectApiKey": "assert_project_key_here",
  "projectId": "project_123"
}

2. Fügen Sie den MCP-Server zu Ihrer Agenten-Konfiguration hinzu:

{
  "mcpServers": {
    "assert": {
      "command": "npx",
      "args": ["-y", "@assert-click/mcp"],
      "env": {
        "ASSERT_CONFIG": "/absolute/path/to/assert.config.json"
      }
    }
  }
}

Das ist alles. Ihr Agent hat nun Zugriff auf alle vier Assert-Tools.

Umgebungsvariablen

• ASSERT_API_KEY: API-Schlüssel (Alternative zur Speicherung in assert.config.json)

• ASSERT_PROJECT_ID: optionale Standard-Projekt-ID

• ASSERT_CONFIG: optionaler Pfad zu einer Konfigurationsdatei oder einem Verzeichnis

Konfigurationsdateien

Der MCP-Server sucht vom aktuellen Verzeichnis aufwärts nach diesen Dateien:

• assert.config.json

• assert.config.local.json

assert.config.local.json wird über assert.config.json zusammengeführt.

Wenn Sie umgebungsbasierte Geheimnisse bevorzugen, anstatt den Schlüssel zu committen:

{
  "projectApiKeyEnv": "ASSERT_API_KEY",
  "projectId": "project_123"
}

Tools

assert_generate

Generieren Sie ein Markdown-Szenario aus einer Beschreibung in einfachem Englisch.

Eingabe:

• description: string — was der Benutzer tun können sollte

• url: string — die Start-URL

• project_id?: string

• save?: boolean — im Projekt speichern (Standard: true)

Rückgabe:

{
  "scenario_id": "scenario_123",
  "markdown": "URL: https://example.com/login\nSCENARIO: Login\nPROCESS:\n  - Fill \"email\" with \"user@example.com\"\nEXPECT: Dashboard",
  "saved": true
}

assert_run

Führen Sie ein gespeichertes Szenario oder ein Ad-hoc-Markdown in einem echten Browser aus.

Eingabe:

• scenario_id?: string

• markdown?: string

• project_id?: string

• request_id?: string

Genau eines der Felder scenario_id oder markdown muss angegeben werden.

Rückgabe:

{
  "run_id": "run_123",
  "status": "queued",
  "estimated_duration_seconds": null
}

assert_status

Abrufen der schrittweisen Ergebnisse für einen Lauf.

Eingabe:

• run_id: string

Rückgabe:

{
  "run_id": "run_123",
  "status": "passed",
  "duration_ms": 4200,
  "steps": [
    {
      "description": "Fill email",
      "status": "passed",
      "error": null,
      "screenshot_url": null
    }
  ],
  "failure_summary": null,
  "full_log_url": null
}

assert_list

Auflisten der gespeicherten Szenarien für ein Projekt.

Eingabe:

• project_id?: string

• cursor?: string

• limit?: number

Rückgabe:

{
  "scenarios": [
    {
      "id": "scenario_123",
      "name": "Login flow",
      "project_id": "project_123",
      "last_run_status": "passed",
      "last_run_at": "2026-03-31T10:00:00.000Z",
      "url": "https://example.com/login"
    }
  ],
  "next_cursor": null
}

Fehler

Fehler werden als strukturiertes JSON zurückgegeben:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The ASSERT_API_KEY is invalid or missing.",
    "field": null
  }
}

Allgemeine Codes:

• INVALID_API_KEY

• SCENARIO_NOT_FOUND

• RUN_NOT_FOUND

• VALIDATION_ERROR

• UPSTREAM_ERROR

Lizenz

MIT