Comando hermes mcp — Referencia Completa y Ejemplos

Descripción General

hermes mcp gestiona las conexiones a servidores MCP (Model Context Protocol) y expone Hermes como servidor MCP. Los servidores MCP añaden herramientas extra que Hermes puede invocar; al ejecutar hermes mcp serve, las conversaciones de Hermes quedan disponibles para otros clientes MCP.

hermes mcp <serve|add|remove|rm|list|ls|test|configure|config|login|reauth|picker|catalog|install>

Subcomandos

serve — Ejecutar Hermes como servidor MCP

hermes mcp serve
hermes mcp serve -v

Expone las conversaciones de Hermes a través de MCP para que otros agentes o IDEs se conecten. Usa -v para obtener logs detallados en stderr.

add — Añadir un servidor MCP

hermes mcp add filesystem --command npx --args @anthropic/mcp-server-filesystem /ruta/permitida
hermes mcp add api-server --url http://localhost:3000/sse
hermes mcp add pg --command npx --args @modelcontextprotocol/server-postgres postgresql://localhost/db --env PGUSER=hermes

Banderas: --url, --command, --args, --auth, --preset, --connect-timeout, --env.

remove / rm — Eliminar un servidor MCP

hermes mcp remove filesystem
hermes mcp rm filesystem

list / ls — Listar servidores configurados

hermes mcp list
hermes mcp ls

test — Probar la conexión a un servidor

hermes mcp test filesystem

configure / config — Alternar selección de herramientas

hermes mcp configure filesystem

login — Re-autenticar un servidor OAuth

hermes mcp login google

reauth — Re-autenticar uno o todos los servidores OAuth

hermes mcp reauth google
hermes mcp reauth --all

picker — Selector interactivo del catálogo

hermes mcp picker

También es el comportamiento por defecto de hermes mcp sin subcomando.

catalog — Listar MCPs aprobados por Nous

hermes mcp catalog

install — Instalar un MCP del catálogo por nombre

hermes mcp install n8n
hermes mcp install official/n8n

Escenarios Comunes

Añadir un servidor de filesystem

hermes mcp add fs --command npx --args @anthropic/mcp-server-filesystem ~/projects
hermes mcp test fs

Ejecutar Hermes en un IDE

hermes mcp serve
# Luego apunta el cliente MCP de tu IDE al servidor Hermes en ejecución.

Gestionar credenciales OAuth

hermes mcp login github
hermes mcp reauth --all

Explorar e instalar desde el catálogo

hermes mcp catalog
hermes mcp install n8n

Consejos

• add y remove (o rm) modifican la configuración MCP del perfil activo.
• Usa --args como última bandera porque consume todo lo que sigue.
• serve expone Hermes como servidor MCP; add consume servidores MCP externos.
• Prueba los servidores nuevos con hermes mcp test <name> antes de confiar en ellos.
• Los servidores OAuth pueden refrescarse con reauth; login fuerza un nuevo flujo para un servidor.