Hermes Agent MCP Mac: Dev-Toolchain anbinden (2026)
Hermes Agent (Nous Research, MIT) bindet über MCP externe Dev-Tools (Filesystem, GitHub, Codex) in ~/.hermes/config.yaml ein.
Warum MCP auf Hermes (Mac)
Client: mcp_servers. Server: hermes mcp serve für Cursor.
Voraussetzung: Hermes Mac Installation.
MCP-Architektur
Stdio für lokale npx-Server; HTTP für OAuth-SaaS. Siehe MCP-Doku.
7-Schritt-MCP-Runbook unter macOS
Schritt 1 — MCP-Extras prüfen
install.sh enthält MCP. Warnt hermes doctor:
cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"
node --version und npx --version prüfen.
Schritt 2 — Filesystem-Server für ein Repo
In ~/.hermes/config.yaml mcp_servers.project_fs mit echtem Projektpfad setzen:
npx -y @modelcontextprotocol/server-filesystem /Users/you/dev/my-app (nicht ganzes $HOME).
Schritt 3 — GitHub aus dem Katalog
hermes mcp oder hermes mcp install github — Token in ~/.hermes/.env, Checkliste für destruktive Tools deaktivieren.
Schritt 4 — Optional: Codex-Preset
Mit codex im PATH: hermes mcp add codex --preset codex.
Schritt 5 — Tool-Whitelist
tools.include und tools.prompts: false setzen, damit nur benötigte mcp_github_* Tools registriert werden.
Schritt 6 — Im TUI testen
hermes starten, Dateien im Projektroot auflisten lassen. Nach YAML: /reload-mcp. OAuth in frischem Terminal: hermes mcp login <server> (Reload in Session nur 30 s).
Schritt 7 — Hermes für Cursor bereitstellen
"command": "hermes", "args": ["mcp", "serve"] in der Client-MCP-Config. Lesen ohne Gateway; Senden mit hermes gateway — siehe Hermes-Installation.
Dev-Szenarien
| Szenario | Transport | Config |
|---|---|---|
| Monorepo | stdio | filesystem-Pfad |
| GitHub | stdio | catalog + .env |
| Codex | preset | --preset codex |
Laptop: ein Root + ein Catalog. Mac mini: wenige stdio-Prozesse parallel.
Fehlerbehebung
MCP-Server verbindet nicht
Symptom: Verbindungsfehler, keine mcp_*-Tools im TUI.
Fix: uv pip install -e ".[mcp]", dann hermes doctor. YAML unter mcp_servers: prüfen.
Tools fehlen
Symptom: Install OK, Agent ruft MCP nie auf.
Ursachen: enabled: false, enge tools.include, OAuth unvollständig. hermes mcp configure github wenn der Server erreichbar ist.
OAuth auf Remote-Mac (SSH)
Symptom: Browser am Laptop, Hermes auf Headless-Mac.
Fix: Redirect-URL einfügen oder ssh -L; hermes mcp login in interaktiver SSH-Session.
FAQ
hermes mcp serve. Cursor für die IDE, Hermes für Messaging oder mcp_servers im Repo — beides parallel möglich.mcp_<server>_<tool> (Punkte werden Unterstriche). Aufgaben in natürlicher Sprache beschreiben ; das Modell wählt Tools.optional-mcps/ sind PR-geprüft, Install führt aber Upstream-Bootstrap aus. Lesen Sie source: im Manifest vor Produktion.supports_parallel_tool_calls: true pro Server — nur für read-only oder konfliktfreie Tools.hermes update erneut hermes mcp install <name> ; neue Tools mit hermes mcp configure <name>.