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, die die Funktionalität des HTTP-Servers, die Interaktionen des MCP-Clients und -Servers sowie Kern-Agentenmethoden wie Geräteverbindung und Befehlsausführung abdecken. 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 Tools, 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 umfasst 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 Tools, 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 umfassen die Konfiguration notwendiger Umgebungsvariablen wie mcpServerUrl, projectKey, projectSecret und deviceName. Für die JSON/HTTP-Version validieren die Tests die Sitzungsinitialisierung, die Auflistung von Tools, 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 simuliert. 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 zusätzlicher Ergebnisse bereitgestellt, um eine robuste Validierung der Kernfunktionalitäten des Agenten zu gewährleisten.
