User Manual
awaBerry Testleitfaden
Testen Sie den awaBerry MCP-Server – Überblick über Testmethoden für die MCP-Schnittstelle, einschließlich HTTP-, WebSocket- und MCP-Client-Validierung.
awaBerry Testleitfaden
Zusammenfassung
Dieser Leitfaden bietet umfassende Verfahren für das lokale Integrationstest von awaBerry-Komponenten. Er deckt die Funktionalität des HTTP-Servers, die Interaktionen des MCP-Clients und -Servers sowie Kern-Agentenmethoden wie Geräteverbindung und Befehlsausführung ab. Die Tests umfassen die Konfiguration von Umgebungsvariablen (`projectKey`, `projectSecret`, `deviceName`, `mcpServerUrl`), um sichere Verbindungen herzustellen und Remote-Befehle (z. B. 'date') auf konfigurierten Geräten auszuführen. Die Validierung stellt die ordnungsgemäße Sitzungsinitialisierung, die Auflistung von Werkzeugen, die Gerätekonnektivität und die zuverlässige Ausführung von Befehlen über verschiedene Transportmechanismen, einschließlich JSON/HTTP und Standard I/O, sicher.
Testen: httpservertest
Diese Seite beschreibt den Prozess zum Testen der HTTP-Server-Komponente. Sie beinhaltet das Starten eines lokalen Node.js HTTP-Servers und die anschließende Ausführung eines Testclient-Skripts. Der Testclient (testHttpServer.js) verbindet sich mit dem Server unter Verwendung von projectKey, projectSecret und deviceName aus einer .env-Datei und sendet anschließend einen execute-Befehl (standardmäßig 'date'), um Informationen von einem konfigurierten Gerät abzurufen.
Testen: mcpclients
Das Skript `testStartAwaberryMcp.js` nutzt `dotenv` zur Verwaltung von Umgebungsvariablen, wobei insbesondere `deviceName` erforderlich ist. Es orchestriert eine Testsequenz über `sendMcpRequest` an einen MCP-Server. Dies beinhaltet die Initialisierung einer Protokollsitzung, die Auflistung verfügbarer Werkzeuge, die Herstellung einer sicheren Verbindung zu einem angegebenen Gerät (Erhalt von `sessionToken` und `deviceuuid`) und schließlich die Ausführung eines Remote-Terminalbefehls wie `date`, um die betriebliche Integrität zu bestätigen. Jeder Schritt wird validiert, wobei ein Fehler an einer beliebigen Stelle zum Abbruch des Prozesses führt.
Testen: mcpservertest
Diese Seite beschreibt den Prozess zum gründlichen Testen des awaBerry MCP-Servers über seine beiden primären Transportmechanismen: JSON/HTTP und Standard I/O (Stdio). Beide Testabläufe beinhalten die Konfiguration notwendiger Umgebungsvariablen wie mcpServerUrl, projectKey, projectSecret und deviceName. Für die JSON/HTTP-Version validieren die Tests die Sitzungsinitialisierung, die Auflistung von Werkzeugen, die Geräteverbindung und die Ausführung von Terminalbefehlen gegen einen HTTP-Endpunkt. Die Stdio-Version führt ähnliche Validierungen durch, indem sie direkt über Standardeingabe/-ausgabe kommuniziert und Client-Interaktionen von Anwendungen wie Claude Desktop nachahmt. Die Tests stellen sicher, dass die Kernfunktionalitäten des Servers betriebsbereit und korrekt konfiguriert sind.
Testen: methodtest
Dieses Dokument beschreibt die technischen Verfahren zur Ausführung lokaler Integrationstests für die Methoden connectToDevice und executeCommand unter Verwendung des awaBerry Connect-Agenten. Es behandelt wesentliche Voraussetzungen wie die Installation von awaBerry Connect und die Einrichtung des Kontos, die Umgebungskonfiguration über eine .env-Datei für Projektanmeldeinformationen und Gerätedetails sowie Schritte zur Installation von Abhängigkeiten. Detaillierte Anweisungen werden für das Testen der Gerätekonnektivität, die Ausführung beliebiger Befehle und die Verwaltung langlaufender Befehle durch Abfragen nach zusätzlichen Ergebnissen bereitgestellt, um eine robuste Validierung der Kernfunktionalitäten des Agenten zu gewährleisten.
