MCP — Connectez Hermes à des milliers d'outils

MCP — Connectez Hermes à des milliers d’outils

Si vous avez déjà souhaité qu’Hermes puisse utiliser un outil qui existe déjà ailleurs — un bot GitHub, un client de base de données, un explorateur de fichiers, une API interne — MCP (Model Context Protocol) est le moyen le plus propre d’y parvenir.

MCP permet à Hermes de se connecter à des serveurs d’outils externes, afin que l’agent puisse utiliser des outils qui vivent en dehors d’Hermes lui-même. Considérez-le comme un adaptateur universel : au lieu d’écrire un outil natif Hermes de zéro, vous pointez simplement Hermes vers un serveur MCP et il découvre quels outils sont disponibles.

Ce que MCP vous apporte

Accès aux écosystèmes d’outils externes sans avoir à écrire d’abord un outil natif Hermes
Serveurs locaux et distants — les serveurs stdio et les serveurs MCP HTTP fonctionnent dans la même configuration
Découverte automatique des outils au démarrage — Hermes trouve et enregistre tout automatiquement
Wrappers utilitaires pour les ressources et invites MCP lorsque le serveur les prend en charge
Filtrage par serveur — n’exposez que les outils MCP que vous voulez réellement qu’Hermes voie

Démarrage rapide

La prise en charge de MCP est incluse dans l’installation standard — aucune étape supplémentaire n’est nécessaire. Voici comment commencer :

1. Ajoutez un serveur MCP à ~/.hermes/config.yaml :

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

2. Démarrez Hermes :

hermes chat

3. Demandez à Hermes d’utiliser la capacité basée sur MCP.

Par exemple :

Liste les fichiers dans /home/user/projects et résume la structure du dépôt.

Hermes découvrira les outils du serveur MCP et les utilisera comme n’importe quel autre outil. C’est tout — aucune configuration supplémentaire, aucune syntaxe spéciale.

Catalogue : installation en un clic pour les MCP approuvés par Nous

Hermes est livré avec un catalogue organisé de serveurs MCP que l’équipe de Nous a examinés et fusionnés. Ils sont désactivés par défaut — installez uniquement ce dont vous avez réellement besoin.

hermes mcp                # sélecteur interactif (par défaut)
hermes mcp catalog        # liste en texte brut, scriptable
hermes mcp install n8n    # installe une entrée du catalogue par son nom

Le sélecteur affiche chaque entrée avec son statut actuel :

n8n          disponible             Gérez et inspectez les workflows n8n depuis Hermes
linear       activé                 Gestion des problèmes/projets Linear (OAuth distant)
github       installé (désactivé)   Outils dépôt GitHub + PR

Appuyez sur Entrée sur une ligne pour installer, activer, désactiver ou désinstaller. Les entrées du catalogue peuvent nécessiter différents types d’identifiants :

Clé API — Hermes demande à l’installation et écrit la valeur dans ~/.hermes/.env
OAuth (MCP distant) — écrit comme auth: oauth dans votre configuration ; le client MCP ouvre un navigateur à la première connexion
OAuth (fournisseur tiers) — Hermes vous oriente vers hermes auth <provider> si vous ne vous êtes pas encore authentifié

Sélection des outils à l’installation

Après la configuration des identifiants, Hermes sonde le serveur MCP pour lister chaque outil qu’il expose et présente une liste de cases à cocher :

Sélectionnez les outils pour 'linear' (ESPACE pour basculer, ENTRÉE pour confirmer)
  [x] find_issues       Trouver les problèmes correspondant à une requête
  [x] get_issue         Obtenir un problème individuel
  [x] create_issue      Créer un nouveau problème
  [ ] delete_workspace  Supprimer un espace de travail Linear
  ...

Les lignes pré-cochées proviennent de :

Votre sélection précédente si vous avez déjà installé cette entrée
tools.default_enabled du manifeste si l’entrée en déclare un
Tout si aucun des deux ne s’applique

Soumettez la liste avec ENTRÉE. Seuls les outils cochés se retrouvent dans mcp_servers.<name>.tools.include. Si vous sélectionnez tout, aucun filtre n’est écrit — forme de configuration la plus propre, comportement identique.

Si la sonde échoue (serveur injoignable, OAuth pas encore terminé), l’installation réussit quand même : les valeurs par défaut du manifeste sont appliquées directement, ou aucun filtre n’est écrit. Relancez hermes mcp configure <name> une fois le serveur joignable pour affiner.

Modèle de confiance

Installer une entrée du catalogue exécute ce que le manifeste spécifie — git clone, commandes d’amorçage, et finalement le code du serveur MCP lui-même. Les manifestes sont contrôlés par revue de PR dans le dépôt hermes-agent, donc Nous a examiné chaque entrée avant sa publication — mais vous devriez quand même lire le manifeste avant d’installer, en particulier le champ source: du dépôt, les commandes install.bootstrap: et toute invocation transport.command:.

Les manifestes se trouvent dans optional-mcps/<name>/manifest.yaml sur GitHub. Le sélecteur affiche l’URL source: du manifeste au moment de l’installation pour que vous puissiez vérifier rapidement le dépôt en amont. La page MCP du tableau de bord web affiche les mêmes détails pour chaque entrée du catalogue — transport, type d’authentification, URL de point de terminaison, source d’installation git, commandes d’amorçage et notes de configuration — avec source: rendu comme lien cliquable.

Compatibilité des versions de manifeste

Les manifestes épinglent une manifest_version. Le catalogue est rétrocompatible : si une PR ajoute une entrée avec une version plus récente que celle que votre Hermes installé comprend, le sélecteur affichera un avertissement (⚠ '<name>' nécessite une version plus récente d'Hermes) au lieu de la masquer silencieusement. Lancez hermes update pour installer la dernière version d’Hermes lorsque vous voyez cela.

Substitution `${ENV_VAR}` à l’exécution

Dans transport.command, transport.args, transport.url et headers d’une entrée, les espaces réservés ${VAR} sont résolus à l’exécution à partir de votre environnement — vous pouvez donc garder les secrets hors de votre configuration et les référencer dynamiquement.

Vous venez de Claude Code ?

Le bloc mcpServers dans votre ~/.claude.json correspond à mcp_servers dans le config.yaml d’Hermes — et hermes import-agent claude-code le migre (avec les compétences et les instructions) automatiquement.

MCP est le moyen le plus rapide de donner à Hermes des superpouvoirs sans réinventer la roue. Essayez-le dès aujourd’hui.