Comando hermes mcp — Referência Completa e Exemplos

Visão Geral

hermes mcp gerencia conexões de servidores MCP (Model Context Protocol) e expõe o Hermes como um servidor MCP. Servidores MCP adicionam ferramentas extras que o Hermes pode invocar; hermes mcp serve torna as conversas do Hermes disponíveis para outros clientes MCP.

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

Subcomandos

serve — Executar Hermes como servidor MCP

hermes mcp serve
hermes mcp serve -v

Expõe as conversas do Hermes via MCP para que outros agentes ou IDEs se conectem. Use -v para logs detalhados no stderr.

add — Adicionar um servidor MCP

hermes mcp add filesystem --command npx --args @anthropic/mcp-server-filesystem /caminho/permitido
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

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

remove / rm — Remover um servidor MCP

hermes mcp remove filesystem
hermes mcp rm filesystem

list / ls — Listar servidores configurados

hermes mcp list
hermes mcp ls

test — Testar a conexão com um servidor

hermes mcp test filesystem

configure / config — Alternar seleção de ferramentas

hermes mcp configure filesystem

login — Re-autenticar um servidor OAuth

hermes mcp login google

reauth — Re-autenticar um ou todos os servidores OAuth

hermes mcp reauth google
hermes mcp reauth --all

picker — Seletor interativo de catálogo

hermes mcp picker

Esse também é o comportamento padrão ao executar hermes mcp sem subcomando.

catalog — Listar MCPs aprovados pela Nous

hermes mcp catalog

install — Instalar um MCP do catálogo por nome

hermes mcp install n8n
hermes mcp install official/n8n

Cenários Comuns

Adicionar um servidor de filesystem

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

Executar Hermes em um IDE

hermes mcp serve
# Depois aponte o cliente MCP do seu IDE para o servidor Hermes em execução.

Gerenciar credenciais OAuth

hermes mcp login github
hermes mcp reauth --all

Explorar e instalar do catálogo

hermes mcp catalog
hermes mcp install n8n

Dicas

• add e remove (ou rm) modificam a configuração MCP do perfil ativo.
• Use --args como última flag, pois ela consome tudo que vem depois.
• serve expõe o Hermes como servidor MCP; add consome servidores MCP externos.
• Teste novos servidores com hermes mcp test <nome> antes de confiar neles no chat.
• Servidores OAuth podem ser atualizados com reauth; login força um novo fluxo para um servidor.