@testneo/mcp-server (v1)

Model Context Protocol (MCP)-Server für TestNeo-Qualitäts-Workflows.

Dieser Server stellt TestNeo-Projekt-/Ausführungstools für MCP-kompatible IDE-Clients (Cursor, Claude Desktop, VS Code MCP-Clients usw.) bereit.

Öffentlicher Mirror (MCP Market / GitHub)

Der eigenständige Open-Source-Mirror, der für Auflistungen und zum Teilen verwendet wird, ist:

https://github.com/gururajhm-neo/testneo-mcp

Dieses Verzeichnis ist die Single Source of Truth innerhalb des TestNeo-API-Monorepos. Um das öffentliche Repository nach Änderungen an diesem Paket zu aktualisieren, führen Sie Folgendes aus:

./scripts/sync-public-mcp-repo.sh /path/to/your/local/testneo-mcp-clone

Führen Sie dann git commit + git push von diesem Klon aus. Lizenz: GPL-3.0 — siehe LICENSE. Sicherheitsmeldungen: siehe SECURITY.md.

Related MCP server: code-graph-mcp

Antworten

• Jedes Tool führt _telemetry in den JSON-Ergebnissen zusammen: request_id, tool, duration_ms, backend_paths (METHOD Pfad pro Backend-Aufruf, der von diesem Prozess nachverfolgt wird), sowie den Schema-Marker telemetry_schema_version und Best-Effort-Dimensionen (project_id, nullbare tenant_id).

• testneo_get_failure_bundle (und Triage-intensive testneo_run_agent_workflow-Schritte) können suggested_nlp_patch enthalten, wenn include_nlp_patch_suggestion auf true gesetzt ist (Standard). Vollständige Tool-Liste und Verträge: docs/MCP_TOOL_REFERENCE.md (wird über scripts/sync-public-mcp-repo.sh mit dem docs/mcp-tool-reference.md des Monorepos synchron gehalten).

• Projekt-Ausführungsvoraussetzungen (standardmäßig an): Generierungs- und Ausführungstools geben project_precondition_failed zurück, es sei denn, das Projekt löst eine echte http(s)-Basis-URL auf (website_url oder Umgebungsvariable base_url). Lehnt example.com-Platzhalter ab. Nur für Sonderfälle deaktivieren: TESTNEO_MCP_RELAX_PROJECT_PRECONDITIONS=true.

• Normalisierung von Ausführungsverträgen: Execution-Intelligence-Tools geben contract_version: execution_intelligence.v1 und kanonische Status (queued | running | passed | failed | cancelled | unknown) aus, während der rohe Backend-Status beibehalten wird.

v1-Umfang

Leseintensive Tools + geschützte Schreibaktionen:

• testneo_validate_connection

• testneo_list_projects

• testneo_get_project_route_map (Lese-Projekt-Ebene Routenhärtungskarte/-profil)

• testneo_list_unified_contexts (Kontexte nach Name + ID durchsuchen)

• testneo_get_unified_context_by_name (Auflösen von context_id ohne UI)

• testneo_list_recent_executions

• testneo_get_execution_status

• testneo_get_execution_summary

• testneo_get_execution_logs

• testneo_get_pass_fail_trend

• testneo_watch_execution

• testneo_get_failure_bundle

• testneo_run_agent_workflow (triage_failure_workflow, rerun_decision_workflow, qa_intelligence_workflow)

• testneo_ingest_figma_context (Figma ETL + Erstellung eines vereinheitlichten Kontexts)

• testneo_generate_tests_from_context (vereinheitlichter Kontext -> NLP-Testgenerierung; optionale Routenhärtung)

• testneo_preview_generated_tests (Human-in-the-loop-Vorschau: NLP + Playwright-Spezifikationsentwürfe)

• testneo_apply_route_hardening (schreibgeschützt: Normalisierung vager Navigate-to-Zeilen mithilfe von Phrasenkarten)

• testneo_set_project_route_map (Persistierung der Routenkarte/-profils auf Projektebene; geschütztes Schreiben)

• testneo_execute_generated_test_case (geschützte Ausführung genehmigter generierter Tests)

• testneo_update_test_case_nlp (Aktualisierung der NLP-Befehle für einen generierten Test)

• testneo_export_playwright_spec (Exportieren des generierten Tests als Playwright SDK .spec.ts)

• testneo_run_playwright_spec_preview (Ausführen des geparsten ai.run-Flows aus dem Spezifikationsentwurf)

• testneo_figma_to_tests_workflow (End-to-End Figma -> Kontext -> Tests -> Vorschau)

• testneo_search_failures

• testneo_rerun_failed (standardmäßig Vorschau; Ausführung erfordert TESTNEO_MCP_ALLOW_WRITE=true und confirm=true)

• testneo_trigger_playwright_execution (erfordert TESTNEO_MCP_ALLOW_WRITE=true und confirm=true)

• Swagger/OpenAPI-Intelligenz

  • testneo_swagger_preview (schreibgeschützt: Spezifikation von base64 parsen → Tags, Endpunktanzahl)

  • testneo_swagger_upload_and_generate (Webprojekt: Swagger + optionale Geschäftsregeln → Kontext + NLP-Tests; Schreiben + Bestätigen)

  • testneo_swagger_impact_analysis / testneo_swagger_impact_actions (Web: Diff vs. Snapshot, Triage-Aktionen; Schreiben + Bestätigen)

  • testneo_api_project_upload_openapi / testneo_api_project_openapi_impact (klassische API-Projekte; Schreiben + Bestätigen)

Einrichtung

cd packages/testneo-mcp-server
npm install
npm run build

Erforderliche Umgebungsvariablen:

• TESTNEO_BASE_URL (Beispiel: http://localhost:8001)

• TESTNEO_API_KEY

Optional:

• TESTNEO_MCP_ALLOW_WRITE=false (Standard)

• TESTNEO_MCP_RELAX_PROJECT_PRECONDITIONS=false (Standard) — auf true setzen, um nur bei Generierungs-/Ausführungstools die Überprüfung der ausführbaren Basis-URL zu überspringen

• TESTNEO_MCP_TELEMETRY_JSONL=false (Standard) — auf true setzen, um pro Tool-Aufruf eine JSON-Zeile an stderr auszugeben (outcome, request_id, duration_ms, backend_paths)

• TESTNEO_MCP_POLICY_MODE=strict (Standard) oder warn — Verhalten der Voraussetzungsrichtlinie (strict blockiert bei Blocker-Ergebnissen, warn stuft einige Prüfungen herab)

• TESTNEO_MCP_TIMEOUT_MS=20000

• TESTNEO_MCP_SWAGGER_TIMEOUT_MS=120000 (Swagger Multipart + schwere OpenAPI-Impact-JSON-Aufrufe)

• TESTNEO_MCP_USER_AGENT=@testneo/mcp-server

• TESTNEO_ROUTE_HARDENING=true (Standard) — auf false setzen, um Phrasen→Pfad-Umschreibungen global zu deaktivieren

• TESTNEO_ROUTE_PROFILE=none (Standard) oder saucedemo — optionales voreingestelltes Phrasen-Mapping (für andere Apps nicht erforderlich)

• TESTNEO_ROUTE_MAP_JSON — JSON-Objekt von Phrase → Pfad (z. B. {"checkout overview":"/checkout"}); wird über die Voreinstellung zusammengeführt, wenn das Profil saucedemo ist, oder allein verwendet, wenn das Profil none ist. Pfade sollten mit / beginnen.

Generierung: testneo_generate_tests_from_context verwendet standardmäßig auto_align_saucedemo_route_map=true, sodass Navigate-Zeilen SauceDemo-URLs erhalten, wenn das Auth-Preset SauceDemo ist und Sie kein benutzerdefiniertes Umgebungs-Mapping haben (profile none, leeres JSON-Mapping).

Tests (keine API)

Führt einen Produktions-Build aus, dann Routenhärtung, Erkennung vereinheitlichter Kontexte und Projekt-Voraussetzungsklassifizierer (keine HTTP-Aufrufe an die TestNeo-API):

npm test

Smoke-Check

TESTNEO_BASE_URL="http://localhost:8001" TESTNEO_API_KEY="tn_xxx" npm run smoke

Cursor/IDE-Befehl

Der MCP-Befehl sollte Folgendes ausführen:

node /absolute/path/to/testneo-api/packages/testneo-mcp-server/dist/index.js

Siehe docs/IDE_SETUP.md für Konfigurationsanleitungen und Beispiel-Prompts.

Sicherheitshinweise

• Der API-Schlüssel wird nur aus der Umgebung gelesen.

• Das Schreib-Tool ist standardmäßig deaktiviert.

• Das Trigger-Tool erfordert ein explizites confirm=true.

• Schreib-Tools unterstützen einen optionalen idempotency_key, um bei Wiederholungsversuchen eine erneute/doppelte Ausführung zu verhindern.

Agentische Workflows (Phase 2A)

testneo_run_agent_workflow fügt eine Orchestrierungsschicht über die Kern-Tools hinzu und gibt strukturierte Schritt-Traces zurück:

• triage_failure_workflow: aktuelle Fehler -> Top-Fehlerbündel -> wiederkehrende Themen

• rerun_decision_workflow: aktuelle Fehler -> Planung von Wiederholungskandidaten (zuerst Vorschau)

• qa_intelligence_workflow: vereinheitlichter Intelligenzbericht (Trend + Fehler + Triage + Wiederholungsvorschau)

Figma-zu-Tests-Workflows (Phase 2B)

MCP unterstützt jetzt kontextgesteuerte Generierung mit menschlicher Genehmigung:

• Figma-Metadaten aufnehmen und ETL-Ausgabe in einen vereinheitlichten Kontext verknüpfen

• NLP-Tests aus Kontextentitäten über die bestehende LangGraph-Pipeline generieren

• Generierte Tests sowohl im NLP- als auch im Playwright SDK .spec.ts-Entwurfsformat in der Vorschau anzeigen

• Genehmigte generierte Tests durch geschützte Schreibaktionen ausführen