MCP — Conecta Hermes a miles de herramientas

MCP — Conecta Hermes a miles de herramientas

Si alguna vez deseaste que Hermes pudiera usar una herramienta que ya existe en otro lugar — un bot de GitHub, un cliente de base de datos, un explorador de archivos, una API interna — MCP (Model Context Protocol) es la forma más limpia de lograrlo.

MCP permite que Hermes se conecte a servidores de herramientas externos, para que el agente pueda usar herramientas que viven fuera de Hermes mismo. Piénsalo como un adaptador universal: en lugar de escribir una herramienta nativa de Hermes desde cero, solo apuntas a Hermes hacia un servidor MCP y él descubre qué herramientas están disponibles.

Lo que MCP te ofrece

• Acceso a ecosistemas de herramientas externos sin necesidad de escribir primero una herramienta nativa de Hermes
• Servidores locales y remotos — los servidores stdio y los servidores MCP HTTP funcionan en la misma configuración
• Descubrimiento automático de herramientas al inicio — Hermes encuentra y registra todo automáticamente
• Wrappers de utilidad para recursos y prompts de MCP cuando el servidor los soporta
• Filtrado por servidor — expón solo las herramientas MCP que realmente quieres que Hermes vea

Inicio rápido

El soporte MCP viene incluido con la instalación estándar — no se necesita ningún paso adicional. Así es como empiezas:

1. Agrega un servidor MCP a ~/.hermes/config.yaml:

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

2. Inicia Hermes:

hermes chat

3. Pídele a Hermes que use la capacidad respaldada por MCP.

Por ejemplo:

Lista los archivos en /home/user/projects y resume la estructura del repositorio.

Hermes descubrirá las herramientas del servidor MCP y las usará como cualquier otra herramienta. Eso es todo — sin configuración adicional, sin sintaxis especial.

Catálogo: instalación con un clic para MCP aprobados por Nous

Hermes incluye un catálogo curado de servidores MCP que el equipo de Nous ha revisado e integrado. Están deshabilitados por defecto — instala solo lo que realmente quieras.

hermes mcp                # selector interactivo (por defecto)
hermes mcp catalog        # lista en texto plano, scripteable
hermes mcp install n8n    # instala una entrada del catálogo por nombre

El selector muestra cada entrada con su estado actual:

n8n          disponible             Gestiona e inspecciona flujos de trabajo de n8n desde Hermes
linear       habilitado             Gestión de issues/proyectos de Linear (OAuth remoto)
github       instalado (desactivado)   Herramientas de repositorio + PR de GitHub

Presiona Enter en una fila para instalar, habilitar, deshabilitar o desinstalar. Las entradas del catálogo pueden requerir diferentes tipos de credenciales:

• Clave API — Hermes la solicita al momento de la instalación y escribe el valor en ~/.hermes/.env
• OAuth (MCP remoto) — se escribe como auth: oauth en tu configuración; el cliente MCP abre un navegador en la primera conexión
• OAuth (proveedor de terceros) — Hermes te dirige a hermes auth <provider> si aún no te has autenticado

Selección de herramientas al instalar

Después de configurar las credenciales, Hermes sondea el servidor MCP para listar cada herramienta que expone y presenta una lista de verificación:

Selecciona herramientas para 'linear' (ESPACIO para alternar, ENTER para confirmar)
  [x] find_issues       Encuentra issues que coincidan con una consulta
  [x] get_issue         Obtiene un issue individual
  [x] create_issue      Crea un nuevo issue
  [ ] delete_workspace  Elimina un workspace de Linear
  ...

Las filas marcadas previamente provienen de:

1. Tu selección anterior si ya has instalado esta entrada antes
2. tools.default_enabled del manifiesto si la entrada lo declara
3. Todo si ninguna de las anteriores aplica

Envía la lista de verificación con ENTER. Solo las herramientas marcadas terminan en mcp_servers.<name>.tools.include. Si seleccionas todo, no se escribe ningún filtro — la forma más limpia de configuración, comportamiento idéntico.

Si la sonda falla (servidor inalcanzable, OAuth aún no completado), la instalación igualmente tiene éxito: se aplican los valores predeterminados del manifiesto directamente, o no se escribe ningún filtro. Vuelve a ejecutar hermes mcp configure <name> una vez que el servidor sea alcanzable para refinar.

Modelo de confianza

Instalar una entrada del catálogo ejecuta lo que especifica el manifiesto — git clone, comandos de arranque y, en última instancia, el código propio del servidor MCP. Los manifiestos están sujetos a revisión de PR en el repositorio de hermes-agent, por lo que Nous ha revisado cada entrada antes de publicarla — pero igualmente deberías leer el manifiesto antes de instalar, especialmente el repositorio del campo source:, los comandos de install.bootstrap: y cualquier invocación de transport.command:.

Los manifiestos viven en optional-mcps/<name>/manifest.yaml en GitHub. El selector imprime la URL del source: del manifiesto al momento de la instalación para que puedas verificar rápidamente el repositorio upstream. El panel web, en su página de MCP, muestra el mismo detalle por entrada del catálogo — transporte, tipo de autenticación, URL del endpoint, fuente de instalación git, comandos de arranque y notas de configuración — con el source: renderizado como un enlace clicable.

Compatibilidad de versiones del manifiesto

Los manifiestos fijan una manifest_version. El catálogo es compatible hacia adelante: si un PR agrega una entrada con una versión más nueva que la que tu Hermes instalado entiende, el selector mostrará una advertencia (⚠ '<name>' requiere una versión más reciente de Hermes) en lugar de ocultarla silenciosamente. Ejecuta hermes update para instalar la última versión de Hermes cuando veas eso.

Sustitución de ${ENV_VAR} en tiempo de ejecución

Dentro de transport.command, transport.args, transport.url y headers de una entrada, los marcadores ${VAR} se resuelven en tiempo de ejecución desde tu entorno — así puedes mantener los secretos fuera de tu configuración y referenciarlos dinámicamente.

¿Vienes de Claude Code?

El bloque mcpServers en tu ~/.claude.json se mapea a mcp_servers en el config.yaml de Hermes — y hermes import-agent claude-code lo migra automáticamente (junto con skills e instrucciones).

MCP es la forma más rápida de darle superpoderes a Hermes sin reinventar la rueda. Pruébalo hoy.