# 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.

```bash
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

```bash
npm install
npm run build
```

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

```bash
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`:

```bash
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
```