Wenn der Hermes Agent sich mit dem MCP-Dienst verbindet, priorisiert er, sobald der Dienst nach dem Start ausgeht, den Befehlspfad, das Arbeitsverzeichnis, die Umgebungsvariablen und die STDERR-Protokolle. Die MCP-Konfiguration sieht wie ein kleines JSON/YAML-Problem aus, aber das eigentliche Problem ist oft: "Befehle sind in Hermes' laufender Umgebung nicht gefunden".
Zuerst reproduzieren Sie im Terminal
Kopiere den Befehl und die Args in der MCP-Konfiguration auf denselben Benutzer und dieselbe Shell zur Ausführung. Wenn das Terminal nicht ausgeführt werden kann, läuft Hermes auch magisch nicht. Häufige Situationen sind, dass Node/Python nicht im PATH ist, die virtuelle Umgebung nicht aktiv ist, das Paket nicht installiert ist und der Skriptpfad einen relativen Pfad verwendet.
Vier wichtige Kontrollpunkte
- Befehle einmal mit einem absoluten Pfad, z. B. Python in
/usr/bin/nodeoder Venv. - CWD korrekt: Viele MCP-Server müssen am Kern des Projekts gestartet werden.
- env complete: API-Schlüssel, Konfigurationspfad und Proxy-Variablen existieren nicht nur in der interaktiven Shell.
- Logs mit stderr: Der eigentliche Grund wird normalerweise vor dem Dienst ausgedruckt.
Öffne nicht alle MCPs gleichzeitig
Aktiviere während der Fehlersuche nur einen MCP-Server, stelle sicher, dass er stabil startet, Tools auflistet und eine minimale Anfrage stellt, bevor du dich mit dem nächsten verbindest. Wenn mehrere MCPs gleichzeitig ausfallen, werden die Logs vermischt, was es schwierig macht zu erkennen, wer gerade ausgeht.
Wenn MCP in Cursor- oder Claude Code laufen kann, aber nicht in Hermes, liegt das wahrscheinlich daran, dass die Bootumgebung anders ist. Explizit Pfade, CWD und Env in die Hermes MCP-Konfiguration zu schreiben, ist stabiler, als sich auf den impliziten Zustand der Shell zu verlassen.
