Hermes Agent MCP sur Mac : outils dev (2026)
Hermes Agent (Nous Research, MIT) se connecte à des serveurs MCP pour filesystem, GitHub et Codex via ~/.hermes/config.yaml.
Pourquoi MCP sur Hermes (Mac)
Client MCP : mcp_servers. Serveur : hermes mcp serve pour Cursor.
Définition : outils mcp_<server>_<tool>, stdio + HTTP OAuth.
Prérequis : guide d'installation Hermes Mac.
Architecture MCP
| Élément | Chemin | Rôle |
|---|---|---|
| Config | ~/.hermes/config.yaml | Serveurs |
| Secrets | ~/.hermes/.env | Clés API |
| OAuth | ~/.hermes/mcp-tokens/ | Jetons |
Runbook MCP en 7 étapes sur macOS
Étape 1 — Vérifier les extras MCP
install.sh inclut MCP. Si hermes doctor alerte :
cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"
Vérifiez node --version et npx --version.
Étape 2 — Serveur filesystem sur une racine de dépôt
Dans ~/.hermes/config.yaml, ajoutez mcp_servers.project_fs avec un chemin de projet réel :
npx -y @modelcontextprotocol/server-filesystem /Users/you/dev/my-app (n'exposez pas tout $HOME).
Étape 3 — GitHub via le catalogue
hermes mcp ou hermes mcp install github — token dans ~/.hermes/.env, checklist pour désactiver les outils destructeurs.
Étape 4 — Preset Codex (optionnel)
Si codex est dans le PATH : hermes mcp add codex --preset codex.
Étape 5 — Liste blanche d'outils
Utilisez tools.include et tools.prompts: false pour n'exposer que les outils mcp_github_* nécessaires.
Étape 6 — Vérifier dans le TUI
Lancez hermes, demandez la liste des fichiers à la racine. Après YAML : /reload-mcp. OAuth dans un nouveau terminal : hermes mcp login <server> (reload en session = 30 s).
Étape 7 — Exposer Hermes à Cursor
Ajoutez "command": "hermes", "args": ["mcp", "serve"]. Lecture sans gateway ; envoi avec hermes gateway — voir installation Hermes.
Cas d'usage dev
| Scénario | Transport | Config |
|---|---|---|
| Monorepo | stdio | filesystem + chemin |
| GitHub | stdio | catalog + token |
| Codex | preset | codex mcp-server |
| Linear | HTTP OAuth | auth: oauth |
Portable : filesystem + un catalog. Mac mini 24/7 : limiter les stdio concurrents.
Dépannage
Serveur MCP ne se connecte pas
Symptôme : erreurs de connexion, pas d'outils mcp_* dans le TUI.
Correctif : uv pip install -e ".[mcp]", puis hermes doctor. Vérifiez le YAML mcp_servers:.
Outils absents
Symptôme : install OK mais l'agent n'appelle jamais les outils MCP.
Causes : enabled: false, tools.include trop strict, OAuth incomplet. Lancez hermes mcp configure github quand le serveur répond.
OAuth sur Mac distant (SSH)
Symptôme : navigateur sur le portable, Hermes sur Mac sans écran.
Correctif : collez l'URL de redirection ou ssh -L ; hermes mcp login en SSH interactif.
FAQ
hermes mcp serve) — les deux peuvent coexister. Utilisez Cursor pour l'IDE et Hermes pour les canaux ou mcp_servers sur le dépôt.mcp_<server>_<tool> (les points deviennent des underscores). Décrivez la tâche en langage naturel ; le modèle choisit l'outil.optional-mcps/, mais l'install exécute le bootstrap upstream. Lisez source: dans le manifest avant la prod.supports_parallel_tool_calls: true par serveur — uniquement pour outils en lecture seule ou sans conflit d'écriture.hermes update, relancez hermes mcp install <name> ; nouveaux outils via hermes mcp configure.