MCP — Collega Hermes a migliaia di strumenti | Easy Understand Hermes Agent

MCP — Collega Hermes a migliaia di strumenti

Se hai mai desiderato che Hermes potesse usare uno strumento che esiste già da qualche altra parte — un bot per GitHub, un client di database, un file browser, un’API interna — MCP (Model Context Protocol) è il modo più pulito per farlo accadere.

MCP permette a Hermes di connettersi a server di strumenti esterni, così l’agente può usare strumenti che vivono al di fuori di Hermes stesso. Pensalo come un adattatore universale: invece di scrivere da zero uno strumento nativo per Hermes, basta puntare Hermes a un server MCP e lui capisce da solo quali strumenti sono disponibili.

Cosa ti offre MCP

Accesso a ecosistemi di strumenti esterni senza dover prima scrivere uno strumento nativo per Hermes
Sia server locali che remoti — i server stdio e i server MCP HTTP funzionano nella stessa configurazione
Scoperta automatica degli strumenti all’avvio — Hermes trova e registra tutto automaticamente
Wrapper di utilità per risorse e prompt MCP quando il server li supporta
Filtro per server — esponi solo gli strumenti MCP che vuoi davvero che Hermes veda

Avvio rapido

Il supporto MCP è incluso nell’installazione standard — nessun passaggio extra necessario. Ecco come iniziare:

1. Aggiungi un server MCP a ~/.hermes/config.yaml:

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

2. Avvia Hermes:

hermes chat

3. Chiedi a Hermes di usare la funzionalità basata su MCP.

Per esempio:

Elenca i file in /home/user/projects e riassumi la struttura del repository.

Hermes scoprirà gli strumenti del server MCP e li userà come qualsiasi altro strumento. Tutto qui — nessuna configurazione extra, nessuna sintassi speciale.

Catalogo: installazione con un clic per gli MCP approvati da Nous

Hermes include un catalogo curato di server MCP che lo staff di Nous ha revisionato e integrato. Sono disabilitati per impostazione predefinita — installa solo ciò che ti serve davvero.

hermes mcp                # selettore interattivo (predefinito)
hermes mcp catalog        # elenco in testo semplice, scriptabile
hermes mcp install n8n    # installa una voce del catalogo per nome

Il selettore mostra ogni voce con il suo stato attuale:

n8n          disponibile              Gestisci e ispeziona i workflow n8n da Hermes
linear       abilitato                Gestione issue/progetti Linear (OAuth remoto)
github       installato (disabilitato)   Strumenti repo + PR GitHub

Premi Invio su una riga per installare, abilitare, disabilitare o disinstallare. Le voci del catalogo possono richiedere diversi tipi di credenziali:

Chiave API — Hermes la richiede al momento dell’installazione e scrive il valore in ~/.hermes/.env
OAuth (MCP remoto) — scritto come auth: oauth nella tua configurazione; il client MCP apre un browser alla prima connessione
OAuth (provider di terze parti) — Hermes ti indirizza a hermes auth <provider> se non hai ancora effettuato l’autenticazione

Selezione degli strumenti al momento dell’installazione

Dopo aver configurato le credenziali, Hermes interroga il server MCP per elencare ogni strumento esposto e mostra un elenco con caselle di spunta:

Seleziona gli strumenti per 'linear' (SPAZIO per alternare, INVIO per confermare)
  [x] find_issues       Trova issue che corrispondono a una query
  [x] get_issue         Ottieni una singola issue
  [x] create_issue      Crea una nuova issue
  [ ] delete_workspace  Elimina un workspace Linear
  ...

Le righe già spuntate provengono da:

La tua selezione precedente se hai già installato questa voce in passato
tools.default_enabled del manifest se la voce ne dichiara uno
Tutto se nessuno dei due casi si applica

Invia l’elenco con INVIO. Solo gli strumenti spuntati finiscono in mcp_servers.<nome>.tools.include. Se selezioni tutto, non viene scritto alcun filtro — configurazione più pulita, comportamento identico.

Se la verifica fallisce (server non raggiungibile, OAuth non ancora completato), l’installazione riesce comunque: vengono applicati direttamente i valori predefiniti del manifest, oppure non viene scritto alcun filtro. Esegui di nuovo hermes mcp configure <nome> una volta che il server è raggiungibile per perfezionare.

Modello di fiducia

Installare una voce del catalogo esegue ciò che specifica il manifest — git clone, comandi di bootstrap e, in ultima analisi, il codice del server MCP stesso. I manifest sono sottoposti a revisione PR nel repository hermes-agent, quindi Nous ha revisionato ogni voce prima della pubblicazione — ma dovresti comunque leggere il manifest prima di installare, in particolare il repository nel campo source:, i comandi install.bootstrap: e qualsiasi invocazione transport.command:.

I manifest si trovano in optional-mcps/<nome>/manifest.yaml su GitHub. Il selettore mostra l’URL source: del manifest al momento dell’installazione, così puoi verificare rapidamente il repository upstream. La dashboard web, nella pagina MCP, mostra gli stessi dettagli per ogni voce del catalogo — trasporto, tipo di autenticazione, URL dell’endpoint, sorgente di installazione git, comandi di bootstrap e note di configurazione — con source: reso come collegamento cliccabile.

Compatibilità delle versioni del manifest

I manifest fissano una manifest_version. Il catalogo è compatibile con le versioni future: se una PR aggiunge una voce con una versione più recente di quella che la tua installazione di Hermes comprende, il selettore mostrerà un avviso (⚠ '<nome>' richiede una versione più recente di Hermes) invece di nasconderla silenziosamente. Esegui hermes update per installare l’ultima versione di Hermes quando vedi questo messaggio.

Sostituzione `${ENV_VAR}` a runtime

All’interno di transport.command, transport.args, transport.url e headers di una voce, i segnaposto ${VAR} vengono risolti a runtime dal tuo ambiente — così puoi tenere i segreti fuori dalla configurazione e referenziarli dinamicamente.

Vieni da Claude Code?

Il blocco mcpServers nel tuo ~/.claude.json corrisponde a mcp_servers nel config.yaml di Hermes — e hermes import-agent claude-code lo migra automaticamente (insieme a skills e istruzioni).

MCP è il modo più veloce per dare a Hermes superpoteri senza reinventare la ruota. Provalo oggi.