Pular para o conteúdo principal

Servidor MCP

libretranslate-mcp dá ao Claude Code, ao Codex, ao OpenCode ou a qualquer outro cliente MCP tradução automática através de uma instância do LibreTranslate.

libretranslate-mcp # stdio: o que o cliente MCP executa
libretranslate-mcp --http # http://127.0.0.1:3768/mcp (PORT muda a porta)
libretranslate mcp start # o mesmo em segundo plano; stop/status; boot enable para iniciá-lo no login

Ferramentas​

FerramentaPara quê
libretranslate_translateUm texto ou uma lista, com detecção auto, HTML e alternativas
libretranslate_translate_fileUm documento local, salvo ao lado do original como <nome>.<alvo><ext>
libretranslate_detectOs idiomas candidatos de um texto
libretranslate_languagesOs códigos de idioma, ou os alvos de uma origem
libretranslate_statusSaúde, se uma chave é exigida, o limite de caracteres, os formatos
libretranslate_suggestDevolve uma tradução melhor, quando o usuário pede
libretranslate_resources / libretranslate_describe / libretranslate_callA API crua, operação por operação

O modo HTTP​

  • É stateless e escuta só em 127.0.0.1.
  • Recusa um Host que não seja loopback, contra DNS rebinding.
  • GET /health responde { ok, baseUrl, apiKey, version }, com apiKey dizendo se há uma configurada.
  • POST /shutdown com o token que libretranslate mcp start gera o encerra; é assim que libretranslate mcp stop para o servidor, inclusive no Windows.

No modo stdio, o stdout carrega o protocolo: o servidor só escreve logs no stderr.

Os erros nunca carregam a API key: todo erro de ferramenta passa pelo mesmo mascaramento do SDK.