Hermes sait déjà lire des fichiers avec ses outils natifs. Pourquoi lui ajouter un serveur pour le faire ? Ici, le fichier sert de point de repère : son contenu est facile à vérifier, ce qui permet de comprendre le branchement MCP avant de connecter un service plus complexe.
Nous allons créer un petit dossier, y déposer une note, puis demander à Hermes de la lire par le serveur MCP. Si l’agent utilise simplement son terminal ou son outil de lecture habituel, l’essai n’aura pas vérifié ce que nous cherchons.
1. Vérifier les prérequis
Il te faut un Hermes installé, un modèle qui répond et sait appeler des outils, ainsi qu’un terminal Linux ou WSL. Si tu débutes, commence par l’installation d’Hermes et les premiers outils utiles.
L’exemple lance Hermes et le serveur MCP dans le même environnement local. Sous Windows, ouvre la distribution WSL où Hermes est installé. Si Hermes tourne sur un VPS, c’est sur ce VPS que tu prépareras les fichiers et les commandes de ce parcours.
Le serveur retenu est @modelcontextprotocol/server-filesystem, en version 2.2.0 pour cet exemple. Cette version demande Node.js 24 ou plus. Installe une version LTS compatible depuis le site officiel Node.js si nécessaire, puis vérifie aussi la présence de npm et npx :
node --version
npm --version
npx --version
hermes -p default mcp --help
Node exécute le serveur ; npx permet de lancer son paquet npm et peut le télécharger au premier usage. Un accès au registre npm sera donc nécessaire si le paquet n’est pas déjà disponible en cache. Le modèle choisi dans Hermes peut lui aussi utiliser un service distant : « serveur MCP local » ne signifie pas que toute la session reste hors ligne.
Nous utiliserons le profil default partout. Remplace-le dans chaque commande si tu travailles avec un autre profil. Si ta version d’Hermes ne connaît pas les commandes MCP présentées ici, consulte le parcours de mise à jour avant de poursuivre.
2. Créer le dossier et son fichier de référence
Prépare un dossier neuf, sans document personnel ni lien vers un autre dossier. La commande suivante crée un nom unique dans ton répertoire utilisateur, puis écrit trois lignes dans note.txt. Elle ne réutilise pas un ancien dossier d’essai.
MCP_DEMO_DIR=$(mktemp -d "$HOME/tekbrut-mcp-XXXXXX") && {
printf '%s\n' \
'Projet : atelier de lecture.' \
'Prochaine action : préparer une fiche courte.' \
'Repère : citron-47.' > "$MCP_DEMO_DIR/note.txt"
printf 'Dossier à déclarer : %s\n' "$MCP_DEMO_DIR"
cat "$MCP_DEMO_DIR/note.txt"
}
Garde le chemin absolu affiché. Il ressemblera à /home/ton-compte/tekbrut-mcp-Ab12Cd, mais le tien sera différent. Nous le réutiliserons dans la configuration et dans les consignes. N’y remplace pas le chemin par $MCP_DEMO_DIR ou ~ : copie sa valeur complète.
citron-47. C’est ta référence locale. Le donner ensuite à Hermes dans la question ne prouverait rien : nous lui demanderons de le retrouver par lecture.3. Comprendre le trajet de la demande
MCP, pour Model Context Protocol, permet à un client comme Hermes de découvrir et d’appeler les capacités proposées par un serveur. Dans cet exemple, le serveur est un programme lancé localement ; il n’y a pas de serveur web à héberger ni de port à ouvrir.
Les échanges passent par stdio : les entrées et sorties du processus servent à transporter les messages MCP. Tu ne discutes pas directement avec ce programme ; Hermes joue le rôle de client.
Lire un fichier avec MCP
Exemple local : Hermes lance le serveur et échange avec lui via stdio.
Outil, serveur et skill : trois rôles différents
| Élément | Son rôle ici |
|---|---|
| Outil | Une action précise, comme list_directory ou read_text_file |
| Serveur MCP | Le programme filesystem qui expose ces outils et les exécute |
| Skill | Une méthode de travail qu’Hermes peut suivre ; elle n’est pas nécessaire à ce branchement |
Le backend du terminal d’Hermes est un autre réglage. Le choisir en Docker ou en SSH ne suffit pas à déplacer ce serveur MCP local. Pour démêler les lieux d’exécution, retrouve le tuto local, Docker et SSH.
4. Déclarer un seul serveur dans le bon profil
Ferme la conversation Hermes de ce profil. Ouvre sa configuration et enregistre une copie du fichier avec ton éditeur avant de le modifier :
hermes -p default config edit
Ajoute le bloc ci-dessous en remplaçant uniquement le chemin d’exemple par celui de l’étape 2. lecture_demo est le nom de ce branchement. S’il existe déjà, choisis un autre nom et remplace-le aussi dans les commandes et consignes qui suivent.
Si ton fichier contient déjà mcp_servers:, ajoute lecture_demo: sous cette clé, au même niveau que les autres serveurs. Ne crée pas une deuxième clé mcp_servers: et conserve les autres entrées. Le YAML utilise des espaces pour l’indentation, pas des tabulations.
mcp_servers:
lecture_demo:
command: "npx"
args:
- "-y"
- "@modelcontextprotocol/server-filesystem@2.2.0"
- "--read-only"
- "--confine-roots"
- "/home/ton-compte/tekbrut-mcp-Ab12Cd"
tools:
include:
- "list_allowed_directories"
- "list_directory"
- "read_text_file"
resources: false
prompts: false
Le numéro de version fixe le paquet principal utilisé par cet exemple ; il ne fige pas toutes ses dépendances. -y autorise npx à télécharger le paquet sans question supplémentaire. Relis donc le nom avant d’enregistrer.
Trois réglages ont des rôles distincts :
--read-onlyretire les outils d’écriture exposés par ce serveur ; sans ce mode, filesystem sait aussi écrire.--confine-rootsempêche les dossiers annoncés par un client compatible avec le mécanisme Roots d’élargir le périmètre passé au lancement.tools.includelimite les outils présentés à Hermes à ceux de notre essai. Les accès MCP facultatifs aux ressources et aux prompts sont désactivés ici.
5. Vérifier la connexion avant la lecture
Enregistre la configuration, puis reviens au terminal. Ces commandes utilisent le même profil :
hermes -p default mcp list
hermes -p default mcp test lecture_demo
La liste doit contenir lecture_demo. Le test tente une connexion réelle : il peut télécharger puis lancer le programme défini dans la configuration. S’il échoue, garde le message exact et consulte le tableau de dépannage plus bas avant de poursuivre.
Un test de connexion réussi ne prouve pas encore qu’Hermes a lu ton fichier. Ouvre ensuite une nouvelle conversation :
hermes -p default chat
Repère les outils rattachés à lecture_demo. Le nom complet affiché peut inclure un préfixe MCP et le nom du serveur ; utilise celui de ta version plutôt que de déduire sa forme. Le nom natif read_text_file, par exemple, ne doit pas être confondu avec un outil de lecture intégré à Hermes.
6. Lister, lire et comparer
Commence par vérifier le périmètre que le serveur annonce. Aucune lecture de fichier n’est encore nécessaire.
Le résultat doit correspondre à ton dossier de test, éventuellement avec sa forme résolue si le système utilise un lien pour son chemin. Si le périmètre est inattendu, arrête l’essai et vérifie la configuration avant de demander la lecture.
Remplace maintenant le chemin dans la consigne suivante par le tien :
Observe les appels d’outils et leurs sorties, puis la réponse d’Hermes. Le nom du serveur, le chemin envoyé et le contenu retourné permettent de suivre ce qui s’est passé.
- Le serveur annonce le dossier de test comme périmètre.
- L’appel MCP de liste retrouve
note.txt. - L’appel MCP de lecture renvoie les trois lignes créées à l’étape 2, dont le même repère.
La reformulation finale doit correspondre au fichier. Une bonne réponse obtenue avec un autre outil ne valide pas le branchement MCP. Inversement, une connexion réussie sans appel de lecture valide seulement la connexion.
7. Garder ou désactiver ce branchement
Ce premier serveur est un exercice pour comprendre le mécanisme. Pour tes lectures quotidiennes, les outils natifs d’Hermes peuvent suffire. Garde MCP lorsqu’il t’apporte une capacité ou une intégration utile, avec un périmètre que tu comprends.
Si tu ne conserves pas l’essai, ferme la conversation puis rouvre la configuration du même profil. Ajoute enabled: false sous lecture_demo:, au même niveau que command: et args:. Tu peux aussi retirer uniquement cette entrée. Ouvre une nouvelle session pour repartir avec cette configuration.
Désactiver l’entrée ne supprime pas ton dossier de test ni le cache npm. Tu pourras supprimer ce dossier séparément après avoir vérifié son chemin ; cela ne fait pas partie du branchement MCP.
Retrouver la cause d’un blocage
| Ce que tu observes | Ce que tu vérifies d’abord |
|---|---|
node, npm ou npx est introuvable | Installation dans le même Linux/WSL ou sur le même VPS qu’Hermes ; nouveau terminal après installation |
| Erreur de version Node | Node 24 ou plus pour le paquet retenu, y compris lorsque npx est lancé par Hermes |
| Le paquet ne se télécharge pas | Accès au registre npm, nom exact et version du paquet ; distingue téléchargement et connexion MCP |
lecture_demo n’apparaît pas | Bon profil, YAML enregistré, une seule clé mcp_servers, indentation correcte |
| Connexion MCP refusée ou incompatible | Message du test, version d’Hermes et documentation de compatibilité ; n’ajoute pas un second serveur pour contourner l’erreur |
| Le dossier est introuvable ou refusé | Chemin absolu de l’étape 2, présence sur la machine du serveur, permissions et périmètre annoncé |
| Hermes lit avec un autre outil | Appel effectivement choisi ; redemande le serveur MCP précis et arrête si ses outils ne sont pas disponibles |
| Des outils d’écriture restent accessibles | Distingue les outils natifs, ceux des autres serveurs et ceux de lecture_demo ; vérifie les options et la nouvelle session |
La suite logique
Tu as relié trois éléments observables : un serveur connecté, un outil appelé et un résultat comparé au fichier d’origine. C’est ce même raisonnement qui servira pour une base de données ou un service distant, avec des permissions et des prérequis propres à chaque intégration.
Pour apprendre à donner ensuite une méthode de travail réutilisable à Hermes, poursuis avec comprendre les skills et créer une première skill.
Ce parcours est proposé pour être reproduit ; aucun essai complet Hermes/MCP n’a été exécuté pour cet article. Les versions et options ont été vérifiées dans les sources officielles le 8 novembre 2026 : MCP dans Hermes, configuration et filtrage, commandes MCP, serveur filesystem et version du paquet et prérequis Node.