mcp-translate

Dois componentes para sessões de Claude Code em português com menor custo de tokens.

Dependência única: Ollama com Gemma 3 2B. Um modelo local, zero custo, atende os dois componentes.

curl -fsSL https://ollama.com/install.sh | sh
ollama pull gemma3:2b

---

1. MCP de Tradução PT/EN

Traduz as mensagens do usuário de português para inglês antes de chegar ao Claude, e as respostas de inglês para português antes de chegar ao usuário. O Claude Opus processa só inglês, que usa cerca de 9% menos tokens que português.

Setup

npm install
npm run build

O .claude/settings.json já registra o servidor. Variáveis de ambiente opcionais:

OLLAMA_URL=http://localhost:11434   # padrão
OLLAMA_MODEL=gemma3:2b              # padrão

---

2. Hook de Resumo de Progresso

Um hook PostToolUse que observa cada ação do Claude (edição de arquivo, comando rodado, leitura) e usa o mesmo Ollama para gerar um resuminho em português visível ao usuário. O texto nunca entra no contexto do Claude, então custa zero tokens.

O hook já está em .claude/hooks/progress-summary.sh e registrado no .claude/settings.json. Requer jq:

apt install jq

Como funciona

Claude edita arquivo
       ↓
Hook captura o evento (tool name + resultado)
       ↓
Gemma 3 2B gera resuminho em português
       ↓
Texto aparece no terminal para o usuário
       ↓
Claude nunca escreve esse texto → zero tokens gastos

---

Arquitetura

Usuário (PT)
    ↓ translate_pt_to_en (MCP → Ollama)
Claude Opus processa em inglês
    ↓ translate_en_to_pt (MCP → Ollama)
Usuário lê em português

A cada ação do Claude:
    PostToolUse hook → Ollama → resuminho no terminal