🚀 operative.sh web-eval-agent MCP-Server

Überlassen Sie dem Codieragenten die Fehlerbehebung selbst, Sie haben Besseres zu tun.

🔥 Optimieren Sie Ihr Debugging

Der MCP-Server von operative.sh startet einen browserbasierten Agenten, um Web-Apps direkt in Ihrem Code-Editor autonom auszuführen und zu debuggen.

Related MCP server: Mentor MCP Server

⚡ Funktionen

• 🌐 Navigieren Sie mit BrowserUse durch Ihre Webanwendung (2x schneller mit operativem Backend)

• 📊 Erfassen Sie den Netzwerkverkehr – Anfragen werden intelligent gefiltert und in das Kontextfenster zurückgegeben

• 🚨 Konsolenfehler erfassen – erfasst Protokolle und Fehler

• 🤖 Autonomes Debuggen – der Cursor-Agent ruft den MCP-Server des Web-QA-Agenten auf, um zu testen, ob der von ihm geschriebene Code durchgängig wie erwartet funktioniert.

🧰 MCP-Tool-Referenz

Hauptargumente

• web_eval_agent

  • url(erforderlich) – Adresse der laufenden App (z. B. http://localhost:3000 )

  • task(erforderlich) – Beschreibung in natürlicher Sprache, was getestet werden soll („den Anmeldefluss durchlaufen und etwaige UX-Probleme notieren“)

  • headless_browser(optional, Standard – auf true setzen, um das Browserfenster auszublenden

• setup_browser_state

  • url(optional) – zuerst zu öffnende Seite (praktisch, um direkt auf einem Anmeldebildschirm zu landen)

Sie können diese Tools direkt aus Ihrem IDE-Chat auslösen, zum Beispiel:

Evaluate my app at http://localhost:3000 – run web_eval_agent with the task "Try the full signup flow and report UX issues".

🏁 Schnellstart (macOS/Linux)

1. Voraussetzungen (normalerweise nicht erforderlich):

• brew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• npm: ( brew install npm )

• jq: brew install jq

2. Führen Sie das Installationsprogramm aus, nachdem Sie einen API-Schlüssel erhalten haben (kostenlos)

   • Installiert Dramatiker

   • Installiert UV

   • Fügt JSON für Sie in Ihren Code-Editor (Cursor/Cline/Windsurf) ein!

curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Besuchen Sie Ihre bevorzugte IDE und starten Sie neu, um die Änderungen anzuwenden

4. Senden Sie eine Aufforderung im Chat-Modus, um das Web-Evaluierungs-Agent-Tool aufzurufen! zB

Test my app on http://localhost:3000. Use web-eval-agent.

🛠️ Manuelle Installation

1. Holen Sie sich Ihren API-Schlüssel bei operative.sh

2. UV installieren

curl -LsSf https://astral.sh/uv/install.sh | sh)

4. Installieren Sie Playwright:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

6. Fügen Sie das folgende JSON mit dem API-Schlüssel zu Ihrem entsprechenden Code-Editor hinzu

7. Starten Sie Ihren Code-Editor neu

🔃 Aktualisierung

• uv cache clean

• MCP-Server aktualisieren

    "web-eval-agent": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "webEvalAgent",
        "--from",
        "git+https://github.com/Operative-Sh/web-eval-agent.git",
        "webEvalAgent"
      ],
      "env": {
        "OPERATIVE_API_KEY": "<YOUR_KEY>"
      }
    }

Operativer Discord-Server

🛠️ Manuelle Installation (Mac + Cursor/Cline/Windsurf)

1. Holen Sie sich Ihren API-Schlüssel bei operative.sh

2. UV installieren

curl -LsSf https://astral.sh/uv/install.sh | sh)

3. Installieren Sie Playwright:

npm install -g chromium playwright && uvx --with playwright playwright install --with-deps

4. Fügen Sie das folgende JSON mit dem API-Schlüssel zu Ihrem entsprechenden Code-Editor hinzu

5. Starten Sie Ihren Code-Editor neu

Manuelle Installation (Windows + Cursor/Cline/Windsurf)

Wir verfeinern dies. Bitte öffnen Sie ein Problem, wenn Sie Probleme haben!

1. Führen Sie dies alles in Ihrem Code-Editor-Terminal aus

2. curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

3. Holen Sie sich Ihren API-Schlüssel bei operative.sh

4. UV installieren (curl -LsSf https://astral.sh/uv/install.sh | sh)

5. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install

6. Code-Editor neu starten

🚨 Probleme

• Updates werden in Code-Editoren nicht empfangen, aktualisieren oder neu installieren für die neueste Version: Führen Sie uv cache clean für die neueste aus

• Bei Problemen können Sie gerne ein Problem in diesem Repo oder im Discord eröffnen!

• 5/5 – Statische Apps ohne Änderungen führten kein Screencasting durch, behoben! uv clean + Neustart, um das Problem zu beheben

Änderungsprotokoll

• 29.04. – Agent-Overlay-Update – Agent-Ausführung im Browser pausieren/abspielen/stoppen

📋 Beispiel für einen MCP-Server-Ausgabebericht

📊 Web Evaluation Report for http://localhost:5173 complete!
📝 Task: Test the API-key deletion flow by navigating to the API Keys section, deleting a key, and judging the UX.

🔍 Agent Steps
  📍 1. Navigate → http://localhost:5173
  📍 2. Click     "Login"        (button index 2)
  📍 3. Click     "API Keys"     (button index 4)
  📍 4. Click     "Create Key"   (button index 9)
  📍 5. Type      "Test API Key" (input index 2)
  📍 6. Click     "Done"         (button index 3)
  📍 7. Click     "Delete"       (button index 10)
  📍 8. Click     "Delete"       (confirm index 3)
🏁 Flow tested successfully – UX felt smooth and intuitive.

🖥️ Console Logs (10)
  1. [debug] [vite] connecting…
  2. [debug] [vite] connected.
  3. [info]  Download the React DevTools …
     …

🌐 Network Requests (10)
  1. GET /src/pages/SleepingMasks.tsx                   304
  2. GET /src/pages/MCPRegistryRegistry.tsx             304
     …

⏱️ Chronological Timeline
  01:16:23.293 🖥️ Console [debug] [vite] connecting…
  01:16:23.303 🖥️ Console [debug] [vite] connected.
  01:16:23.312 ➡️ GET /src/pages/SleepingMasks.tsx
  01:16:23.318 ⬅️ 304 /src/pages/SleepingMasks.tsx
     …
  01:17:45.038 🤖 🏁 Flow finished – deletion verified
  01:17:47.038 🤖 📋 Conclusion repeated above
👁️  See the "Operative Control Center" dashboard for live logs.

Sternengeschichte

Erstellt mit <3 @ operative.sh