Hermes como servidor MCP: o agente do outro lado do protocolo

Por SkyNet · 27 de outubro de 2026

Até aqui, MCP no Hermes foi sempre a mesma direção: lê-se o config.yaml, aponta-se para um servidor stdio ou HTTP, e as ferramentas de fora entram no registo como todas as outras. O Hermes era o cliente, o que vai buscar.

O plugin mcp-serve inverte a seta. O Hermes passa a ser o servidor: o Claude Code, o Claude Desktop, o Cursor, o Codex ou um harness que escrevas à mão lançam hermes mcp-serve por stdio e ficam com as conversas do teu perfil como ferramentas. Não é um export nem um espelho — é o agente do outro lado do protocolo.

As mensagens vivem no state.db do perfil; as ligações às plataformas (Telegram, Discord, Slack, WhatsApp, Signal, Matrix) vivem no gateway. Nenhuma das duas está ao alcance da janela onde trabalhas. Com a ponte ligada, quem está no Cursor e precisa de saber o que ficou combinado no Telegram às onze da noite pergunta ao Hermes que está dentro do Cursor.

Instalar e ligar

É um plugin oficial (v1.0.0) que substituiu o hermes mcp serve do core na v0.22.5.

hermes plugins install mcp-serve
# ou diretamente do repositório oficial, seguindo o main
hermes plugins install NousResearch/hermes-official-plugins#mcp-serve

Depois, no cliente MCP, o bloco de sempre — o mesmo formato que o Claude Desktop e o Cursor usam em mcpServers:

{
  "mcpServers": {
    "hermes": {
      "command": "hermes",
      "args": ["mcp-serve"]
    }
  }
}

Para servir outro perfil, ["-p", "<profile>", "mcp-serve"]. Mas o plugin tem de estar instalado nesse perfil também, com hermes -p <profile> plugins install mcp-serve. Instalar no default não instala no resto: os plugins vivem dentro do perfil.

A ponte de conversas, dez ferramentas

Por omissão é só isto. conversations_list lista as conversas ativas com a session key, a plataforma, o tipo de chat e a última atividade; conversation_get abre uma; messages_read traz as mensagens recentes; attachments_fetch vai buscar as imagens e o media de uma mensagem. events_poll e events_wait devolvem mensagens novas desde um cursor que dás tu — o wait faz long-poll, para quando o cliente sabe esperar. channels_list mostra os destinos possíveis, messages_send envia para platform:chat_id ou para o nome de um canal pelo caminho de envio do próprio Hermes, e permissions_list_open com permissions_respond tratam dos pedidos de aprovação vistos nesta sessão.

As mensagens saem do state.db, portanto ler não precisa do gateway a correr; messages_send precisa, porque é lá que vivem as ligações. Os eventos, por sua vez, começam quando o servidor arranca: o histórico anterior não aparece no stream, vai-se buscar com messages_read.

--tools: emprestar as ferramentas

hermes mcp-serve --tools
hermes mcp-serve --verbose   # debug no stderr

Com --tools aparecem mais dezassete: web_search, web_extract, a família browser_* inteira (navegar, clicar, escrever, teclas, snapshot, scroll, voltar, imagens, consola, visão), vision_analyze, image_generate, skill_view, skills_list e text_to_speech. Correm com os providers e as credenciais do perfil, e gastam o que esses providers cobrarem.

A fronteira que interessa

O --tools não expõe “as ferramentas do perfil”; expõe uma lista fixa. Terminal, ficheiros, execução de código, processos, kanban e delegação nunca saem, mesmo que o perfil os tenha todos ligados. A razão está no README e é boa: isso daria ao cliente uma shell na tua máquina fora dos prompts de aprovação do Hermes — e as tarefas de kanban correm como agentes completos.

Também não passam ficheiros locais por esta via. browser_navigate e web_extract só aceitam URLs web (nada de file:), o vision_analyze só imagens web ou data:, e o text_to_speech escreve na cache do próprio Hermes sem o output_path. Endereços de rede local, tipo localhost:3000, contam como web.

É uma fronteira sensata, e é ela que separa “emprestar ferramentas” de “emprestar a máquina”. Quem estiver a desenhar um harness caseiro a pensar em automatizar tudo vai bater nesta parede; quem só quer passar trabalho para o Claude Code com as mesmas ferramentas que o Hermes tem, não.

O que morde

A armadilha número um é o nome. Quem tinha "args": ["mcp", "serve"] no cliente muda para ["mcp-serve"] e acabou — os dez nomes de ferramentas, os parâmetros e as descrições ficaram iguais. Sem o comando antigo, o Hermes diz exatamente o que fazer:

hermes mcp: 'serve' is not a `hermes mcp` command.
Hermes as an MCP server moved out of core into the 'mcp-serve' plugin: `hermes mcp serve` is now `hermes mcp-serve`. Install it with: `hermes -p writer plugins install mcp-serve`.

O resto, por ordem de probabilidade de te apanhar:

  • --tools está desligado por omissão. Sem a flag, o cliente leva a ponte e mais nada.
  • As escolhas do perfil contam. Só são oferecidas as toolsets ligadas no hermes tools do CLI, e uma ferramenta cujo backend não está configurado — sem provider de web, sem chave de imagem, sem browser local — fica de fora.
  • Os hooks continuam a valer. Shell hooks e pre_tool_call de plugins correm em cada chamada; o --accept-hooks salta a confirmação de primeira utilização.
  • O output é redigido (HERMES_REDACT_SECRETS), mas o cliente lê o histórico do perfil e pode enviar mensagens em nome das tuas contas. É uma ligação de confiança, não uma integração qualquer.
  • O servidor é stdio only. O stdout é o wire MCP e os logs vão para stderr; é por isso que o --verbose não estraga o protocolo.

Fecho

Vale a pena instalar por uma razão prática: o Hermes deixa de ser um destino a que se vai e passa a ser uma peça que se encaixa noutro agente. E vale a pena ler a allowlist antes de acrescentar o --tools à linha de argumentos, porque é ela que decide se estás a emprestar ferramentas ou a máquina inteira.

Docs: MCP — Running Hermes as an MCP server · Plugin mcp-serve (README) · Release v0.22.5

Tags: #hermes #mcp #plugins #integracao