Hermes Agent Tool-Ökosystem und MCP-Integration

Alle Fähigkeiten von Hermes laufen überTools, die dem Agenten bereitgestellt werden.

Tools werden inToolsetsorganisiert. Toolsets werden dann inPlattformkonfigurationkombiniert. Diese dreischichtige Struktur bestimmt, was der Agent in verschiedenen Szenarien tun kann:

工具(Tool)
  └── 工具集(Toolset)         # 相关工具的逻辑分组
        └── 平台配置            # 哪个平台加载哪些工具集
              └── 自定义工具集   # 你自己定义的组合

Toolkit-Verwaltungsbefehle

# 打开 curses TUI,按平台开/关工具集
hermes tools

# 命令行列出所有工具和状态
hermes tools list

# 按名称启用或禁用工具集
hermes tools enable NAME
hermes tools disable NAME

Desktop-Version, im linken Menü für Skills und Tools:

Deaktiviere ein Toolset, und seine Tools verschwindenvollständigaus dem System-Prompt, nicht nur deaktiviert – das spart direkt Tokens und verhindert, dass der Agent Tools missbraucht, die er nicht verwenden sollte.


Überblick über integrierte Toolkits

Hermes bietet über 70 integrierte Tools, unterteilt in 28 Tool-Sets.

Im Folgenden werden die am häufigsten verwendeten Tool-Sets nach Kategorie vorgestellt.

Dateien und System

ToolsetKerntoolsHauptzweck
Dateiread_file、write_file、list_dirDatei lesen/schreiben, Verzeichnisoperationen
terminalrun_command、run_scriptAusführung von Shell-Befehlen
codeexecute_codeSandbox-Codeausführung (Python/JS/Bash)
computerscreenshot、click、typeDesktop-GUI-Automatisierung

Netzwerk und Inhalte

ToolsetKerntoolsHauptzweck
webweb_search、web_extractWebsuche und Inhaltsextraktion
Browsernavigate、click、fill_formVollständige Browser-Automatisierung
visionanalyze_image、describe_imageBildanalyse und Beschreibung
Audiotranscribe、ttsSprache-zu-Text, Text-zu-Sprache

Agent-Fähigkeiten

ToolsetKerntoolsHauptzweck
memorymemory、session_searchSpeicherverwaltung und sitzungsübergreifender Abruf
skillsskills_list、skill_view、skill_manageSkill-Verwaltung
Delegationspawn_agent、spawn_parallelSub-Agent-Delegierung und Parallelität
kanbantask_create、task_updateMulti-Agent-Dashboard (erfordert explizite Aktivierung)

Medienerstellung

Das folgende Toolset erfordert Nous Portal oder einen entsprechenden API-Schlüssel:

ToolsetFunktionenBeschreibung
image_genText-zu-Bild-GenerierungUnterstützt 9 Modelle, einschließlich FLUX, GPT-Image
ttsText-zu-Sprache10 TTS-Anbieter, einschließlich lokalem Piper

Benutzerdefinierte Toolkits

Sie können vorhandene Tool-Sets in der Konfigurationsdatei zu projektspezifischen Tool-Sets kombinieren:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# Benutzerdefiniertes Toolset: vorhandene Toolsets zu projektspezifischer Konfiguration kombinieren
custom_toolsets
:
  data-science
:
   - file
    - terminal
    - Code
    - Web

Dann beim Start angeben:

Beispiel

# Benutzerdefiniertes Toolset beim Start verwenden
hermes --toolsets data-science

Sechs Terminal-Ausführungs-Backends

Das Terminal-Toolset unterstützt sechs Ausführungs-Backends, die bestimmen,wo die Shell-Befehle des Agenten ausgeführt werden, entsprechend unterschiedlichen Isolationsstufen und "Blast Radius".

BackendOrt der BefehlsausführungIsolationsstufeTypische Szenarien
local (Standard)Lokaler Rechner, aktuelle BenutzerberechtigungenKeinePersönliche Entwicklung, tägliche Nutzung
dockerInnerhalb eines Docker-ContainersVollständige IsolationProduktionsbereitstellung, sichere Sandbox
sshRemote-ServerIsolation der NetzwerkgrenzeRemote-Entwicklung, Hochleistungsrechner
modalModal Cloud-Sandbox (VM)Vollständig (Cloud)Temporäre Compute-, Evaluierungsaufgaben
daytonaDaytona-gehostete WorkspacesVollständig (Cloud-Container)Verwaltete Cloud-Entwicklungsumgebung
singularitySingularity-ContainerNamespace-IsolationHPC-Cluster, gemeinsam genutzte Maschinen

Backend wechseln

Beispiel

# Zum Docker-Backend wechseln (empfohlen für Produktion)
hermes config set terminal.backend docker

# Zum SSH-Backend wechseln
hermes config set terminal.backend ssh
hermes config set terminal.ssh_host user@your-server.com

Vollständiges Konfigurationsbeispiel für Docker-Backend:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# Docker-Backend-Konfiguration
terminal
:
  backend
: docker
  docker_image
: "nikolaik/python-nodejs:python3.11-nodejs20"
  container_persistent
: true    # true = bind mount, false = tmpfs temporär

Sicherheitsprinzip: Das lokale Backend gibt dem Agenten dieselben Dateisystemberechtigungen wie Ihnen—geeignet für persönliche Rechner, nicht geeignet für Produktionsdienste. Das Docker-Backend ist die einfachste und effektivste Isolationsmethode.

Genehmigung gefährlicher Befehle

Standardmäßig fordert Hermes eine Bestätigung an, bevor potenziell zerstörerische Befehle ausgeführt werden:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# Konfiguration des Genehmigungsmodus
approvals
:
  mode
: manual        # manual (Standard) | smart | off
  timeout
: 60         # Sekunden, die auf Genehmigung gewartet wird
  cron_mode
: deny     # Verhalten, wenn eine geplante Aufgabe auf gefährliche Befehle stößt: deny | approve

Vorübergehend die Genehmigung in einer Sitzung umgehen (mit Vorsicht verwenden):

Beispiel

# YOLO-Modus aktivieren, alle Befehle in dieser Sitzung automatisch genehmigen
/yolo

# Erneut eingeben zum Deaktivieren
/yolo

MCP: Verbindung des externen Tool-Ökosystems

MCP (Model Context Protocol) ermöglicht Hermes, eine Verbindung zu externen Tool-Servern herzustellen, ohne den Kerncode zu ändern – GitHub, Datenbanken, Dateisysteme, Browser-Stacks, interne APIs usw.

Die Standardinstallation enthält MCP-UnterstützungKeine zusätzlichen Schritte erforderlich.

Zwei Arten von MCP-Servern

Lokaler stdio-Server: Läuft lokal als Unterprozess und kommuniziert über Standardeingabe/-ausgabe:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# MCP-stdio-Server-Konfiguration
mcp_servers
:
  github
:
    command
: "npx"
    args
: ["-y", "@modelcontextprotocol/server-github"]
    env
:
      GITHUB_PERSONAL_ACCESS_TOKEN
: "ghp_..."

  filesystem
:
    command
: "npx"
    args
: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

  git
:
    command
: "uvx"
    args
: ["mcp-server-git", "--repository", "/home/user/project"]

Anwendungsfälle: Tools sind lokal installiert und ein latenzarmer Zugriff auf lokale Ressourcen ist erforderlich.

Remote-HTTP-Server: direkt mit einem Remote-MCP-Endpunkt verbinden:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# MCP-HTTP-Server-Konfiguration
mcp_servers
:
 # Statische Bearer-Token-Authentifizierung
  internal_api
:
    url
: "https://mcp.internal.example.com/mcp"
    headers
:
      Authorization
: "Bearer ${MY_TOKEN}"

  # OAuth-2.1-Authentifizierung (Linear, Sentry, Figma, Stripe usw.)
  linear
:
    url
: "https://mcp.linear.app/mcp"
    auth
: oauth

  # Anbieter, die vorab registrierte OAuth-Clients erfordern
  googledrive
:
    url
: "https://drivemcp.googleapis.com/mcp/v1"
    auth
: oauth
    oauth
:
      client_id
: "<your-oauth-client-id>"
      client_secret
: "<your-oauth-client-secret>"

Anwendbare Szenarien: Tools werden remote gehostet, oder es gibt eine MCP-Schnittstelle innerhalb der Organisation.

Von Nous kuratiertes MCP-Verzeichnis

Hermes verfügt über ein integriertes, von Nous kuratiertes MCP-Verzeichnis mit Ein-Klick-Installation:

Beispiel

# Interaktiven Selektor öffnen (Standard)
hermes mcp

# Klartextliste
hermes mcp catalog

# Einträge aus dem Verzeichnis nach Namen installieren
hermes mcp install n8n

Der Selektor zeigt den aktuellen Status jedes Eintrags an:

n8n          available              管理和检查 n8n 工作流
linear       enabled                Linear 问题/项目管理(远程 OAuth)
github       installed (disabled)   GitHub 仓库 + PR 工具

Die Installation führt automatisch drei Schritte aus:

  1. Aufforderung zum Konfigurieren eines API-Schlüssels oder Anleitung zur OAuth-Anmeldung
  2. Liste der vom Server bereitgestellten Tools ermitteln
  3. Zeigt eine Tool-Auswahlliste an, damit du entscheiden kannst, welche Tools aktiviert werden

Tool-Filterung: nur das verfügbar machen, was du brauchst

Jeder MCP-Server unterstützt eine feingranulare Tool-Filterung, wodurch die dem Agenten zur Verfügung stehende Angriffsfläche reduziert wird:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# Konfiguration der MCP-Tool-Filterung
mcp_servers
:
  github
:
    command
: "npx"
    args
: ["-y", "@modelcontextprotocol/server-github"]
    env
:
      GITHUB_PERSONAL_ACCESS_TOKEN
: "ghp_..."
    tools
:
      include
: [list_issues, create_issue, update_issue, search_code]
      # Nicht aufgeführte Tools werden nicht registriert
    resources
: false
    prompts
: false

  stripe
:
    url
: "https://mcp.stripe.com"
    headers
:
      Authorization
: "Bearer ${STRIPE_KEY}"
    tools
:
      exclude
: [delete_customer, refund_payment]  # Hochriskante Operationen ausschließen
FieldsVerhalten
tools.includeNur Tools aus der Liste registrieren, alle anderen ausschließen
tools.excludeWerkzeuge in der Liste ausschließen, alle anderen registrieren
Beide festlegenInclude-Priorität
resources: falseMCP-Ressourcenzugriffs-Tools nicht verfügbar machen
prompts: falseMCP-Prompt-Tools nicht verfügbar machen

FilterRulesUsage MCP originalTool-Name (enthält Verbindungszeichen/Punkt), ist nicht Hermes RegisterafterBottom划Lineversion.

Jeder MCP-Server erzeugt ein unabhängiges Toolset

Nach der Konfiguration des GitHub MCP-Servers erstellt Hermes es zur Laufzeit automatischmcp-githubToolset.

Sie können es wie ein integriertes Toolset verwalten:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# MCP-Toolset in Plattformkonfiguration referenzieren
platform_toolsets
:
  cli
:
   - hermes-cli
    - mcp-github
    - mcp-linear

MCP-Konfiguration neu laden

Nach dem Ändern von config.yaml muss der gesamte Agent nicht neu gestartet werden:

Beispiel

# MCP-Server in der Sitzung neu laden (30-Sekunden-Timeout)
/reload-mcp

# Oder von der Kommandozeile
hermes mcp reload

Wenn OAuth-Authentifizierung erforderlich ist, reicht das 30-Sekunden-Timeout nicht aus. Es wird empfohlen, zuerst die Serverkonfiguration hinzuzufügen und dann hermes mcp login <server> in einem neuen Terminal auszuführen, um die Autorisierung abzuschließen (Wartezeit bis zu 5 Minuten).


Editor-Integration (ACP)

ACP (Agent Communication Protocol) ermöglicht es Hermes, nativ im Editor zu laufen – Chat, Tool-Aktivität, Datei-Diffs und Terminalbefehle werden alle direkt im Editor dargestellt.

Unterstützte Editoren: VS Code, Zed und die gesamte JetBrains-Serie.

Die Standardinstallation enthält bereits ACP-Unterstützung:

Beispiel

# Agentenmodus für Editor-Verbindungen starten
hermes acp

Wenn die vollständigen Abhängigkeiten bei der Installation nicht enthalten waren:

Beispiel

# ACP-Abhängigkeiten installieren
cd ~/.hermes/hermes-agent
uv pip install -e ".[acp]"
EditorIntegrationsmethodeFunktionen
VS CodeErweiterungs-PluginInline-Code-Vervollständigung, Code-Review, Refactoring-Vorschläge
ZedNativer Agent-Modusstdio/JSON-RPC-Kommunikation, kontextbewusst
JetBrainsPluginCodegenerierung, Testgenerierung, Dokumentationskommentare

Editor-Integration kommuniziert mit dem Hermes Agent über das stdio/JSON-RPC-Protokoll, ist nicht auf eine Netzwerkverbindung angewiesen und eignet sich für die Offline-Nutzung.


Sprachmodus

Der Sprachmodus unterstützt vollständige Sprachinteraktion über CLI- und Messaging-Plattformen hinweg:

  • Eingabe per Mikrofonaufnahme (lokale Spracherkennung mit faster-whisper, kostenlos)
  • TTS-Sprachantworten (10 Anbieteroptionen verfügbar)
  • Echtzeit-Konversation in Discord-Sprachkanälen

Installieren und aktivieren

Beispiel

# Sprachabhängigkeiten installieren
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"

Beispiel

# Sprachmodus in CLI aktivieren
/voice on
# Ctrl+B drücken, um die Aufnahme zu starten, loslassen zum Senden

# In der Messaging-Plattform
/voice on     # TTS-Antworten aktivieren
/voice tts    # Nur Text-to-Speech aktivieren (ohne Spracheingabe)
/voice off    # Aus

TTS-Anbieter

AnbieterFunktionenKostenlos oder nicht
Edge TTSMicrosoft neuronale Stimmen, mehrsprachigKostenlos
PiperVollständig lokal, niedrige LatenzKostenlos
OpenAI TTSHohe Qualität, mehrere StimmenNutzungsabhängige Abrechnung
ElevenLabsErstklassige Audioqualität, StimmklonungNutzungsabhängige Abrechnung
MiniMaxChinesische OptimierungNutzungsabhängige Abrechnung
Mistral VoxtralmehrsprachigNutzungsabhängige Abrechnung

Tool-Gateway (Nous-Portal-Abonnement)

Abonnieren Sie über Nous Portal, um Cloud-Implementierungen von vier Arten von Tools mit einem Klick zu erhalten, ohne separate API-Schlüssel beantragen zu müssen:

WerkzeugeBeschreibung
WebsucheSuche + Inhaltsextraktion (Web-Toolset)
Bilderstellung9 Modelle: FLUX, GPT-Image, Ideogram usw.
TTSText-zu-Sprache
Cloud-BrowserVollständige Browser-Automatisierung (kein lokales Playwright erforderlich)

Beispiel

# OAuth-Anmeldung, konfiguriert automatisch alle oben genannten Tools
hermes setup --portal

Tool-Sicherheit: Isolierung der MCP-Umgebungsvariablen

MCP-stdio-Unterprozess erhält einegefilterte UmgebungVerhindert versehentliches Durchsickern von Anmeldedaten.

Standardmäßig werden nur die folgenden Variablen an den MCP-Prozess übergeben:

PATH, HOME, USER, LANG, LC_ALL, TERM, SHELL, TMPDIR(以及所有 XDG_* 变量)

Alle anderen Umgebungsvariablen (API Key, Token, Passwort) werden blockiert.

Nur Variablen, die explizit im env:-Block der MCP-Serverkonfiguration deklariert sind, werden übergeben:

Beispiel

# Dateipfad: ~/.hermes/config.yaml
# Nur explizit deklarierte Variablen werden an den MCP-Unterprozess übergeben.
mcp_servers
:
  github
:
    command
: "npx"
    args
: ["-y", "@modelcontextprotocol/server-github"]
    env
:
      GITHUB_PERSONAL_ACCESS_TOKEN
: "ghp_..."   # Nur diese eine wird übergeben

Darüber hinaus werden MCP-Tool-Fehlermeldungen automatisch bereinigt, bevor sie an das LLM zurückgegeben werden, wobei vertrauliche Informationen ersetzt werden durch[REDACTED]。


Kurzübersicht für gängige Befehle

Beispiel

# ─── Tool-Verwaltung ────────────────────────────────────────────────
hermes tools                          # Interaktive Toolset-Verwaltung (TUI)
hermes tools list                     # Alle Tools und Status auflisten
hermes tools enable NAME              # Toolset aktivieren
hermes tools disable NAME             # Toolset deaktivieren

# ─── MCP verwalten ────────────────────────────────────────────────
hermes mcp                            # Interaktive MCP-Verzeichnisauswahl
hermes mcp catalog                    # Verzeichnisauflistung als Klartext
hermes mcp install <name>             # Verzeichniseinträge installieren
hermes mcp add NAME --command CMD     # MCP-Server manuell hinzufügen
hermes mcp remove NAME                # MCP-Server entfernen
hermes mcp list                       # Konfigurierte Server auflisten
hermes mcp test NAME                  # Verbindung testen
hermes mcp login <server>             # OAuth-Autorisierung abschließen
hermes mcp configure <server>         # Tool-Auswahl neu konfigurieren
hermes mcp reload                     # MCP-Konfiguration neu laden

# ─── Terminal-Backend ────────────────────────────────────────────────
hermes config set terminal.backend docker
hermes config set terminal.backend ssh
hermes config set terminal.ssh_host user@host

# ─── ACP EditorSetCheng ──────────────────────────────────────────
hermes acp

# ─── Portal-Abonnement ─────────────────────────────────────────────
hermes setup --portal
Weitere Erweiterungen