Tucano Proxy

Inspecione seu tráfego HTTP sem dor

Um proxy de debug local, livre e leve. Capture, filtre e analise milhares de requisições com uma interface que não trava.

Baixar última versão v0.2.4Ver docs
O que vem dentro

Tudo que você precisa pra debugar HTTP.

Sem configuração manual, sem travamento, sem telemetria. Local do começo ao fim.

MITM em 127.0.0.1:8888

Proxy local com TLS reescrito de ponta a ponta usando uma CA gerada na sua máquina.

Toggle do proxy do sistema

Liga e desliga o proxy do macOS e Windows com um clique. Sem editar configuração à mão.

Certificado raiz auto-assinado

Geração e instalação guiadas. Você decide quando confiar — e quando revogar.

Lista virtualizada

Aguenta dezenas de milhares de requisições sem travar. Scroll suave do começo ao fim.

Filtro com DSL

Filtros poderosos. Combine, inverta, salve.

host:api.foo.com status:>=400

Sessões .tucano

Salva tudo num arquivo SQLite. Compartilha com o time, abre depois, sem perder nada.

Por dentro do app

Capturas reais — não maquetes.

Tucano Proxy — lista de fluxos
Tucano Proxy — flowlist
Tucano Proxy — inspector
Por baixo do capô

Performance, leveza e propósito.

Pensado pra ser rápido em qualquer máquina, escrito em Rust + Tauri, com design minimalista e desenhado com muito carinho pra ajudar a comunidade.

↯

Performático de verdade

Lista virtualizada, parsing em thread separada, zero copy onde dá. Aguenta milhares de requests sem travar a interface.

⌘

Rust + Tauri

Núcleo do proxy em Rust — memória segura, sem GC, binário pequeno. UI nativa via Tauri 2.

◇

Design minimalista

Cada pixel pensado pra sumir de baixo do conteúdo. Cor com propósito, tipografia generosa, sem firula.

~10MB
Tamanho do binário
50k+
Requests por sessão
0₵
Sempre gratuito
Diferencial

Exportação em Markdown pronta pra LLM

Um clique e o Tucano gera um Markdown limpo com prompt customizável e steps estruturados — pra colar direto num Claude, GPT ou agente que está te ajudando a debugar.

  • Prompt customizável + linguagem-alvo. Escolhe C#, TypeScript, Python, Go, Java ou livre — o prompt default já orienta o modelo a seguir o padrão do seu repositório.
  • Steps estruturados com placeholders. Headers sensíveis mascarados, placeholders cross-step ({var1}, {var2}) e dicas de locator (XPath/JSON-path) pra extração.
  • Copia ou salva como .md. Botão de copiar pro clipboard ou salvar como tucano.llm.md. Texto puro, pronto pra colar na conversa.
tucano.llm.md · LLM-ready
# Tucano — Fluxo HTTP capturado

> Você é um engenheiro experiente em TypeScript (fetch).
> Antes de gerar código, inspecione o repo e siga o
> padrão usado para chamadas HTTP.

## Contexto
- Total de chamadas: 2
- Hosts: auth.example.com, api.example.com
- Linguagem-alvo: TypeScript (fetch)
- Headers sensíveis mascarados: sim

## Steps (estruturado)

### 1. POST auth.example.com/login → 200
| header        | value             |
| ------------- | ----------------- |
| content-type  | application/json  |
| authorization | ***REDACTED***    |

### 2. GET api.example.com/me → 200
| authorization | Bearer {var1}  |
mcp config
{
  "mcpServers": {
    "tucano": {
      "type": "http",
      "url": "http://127.0.0.1:7878/mcp",
      "headers": {
        "Authorization": "Bearer paste-the-token-from-tucano-settings"
      }
    }
  }
}
Novo · MCP

Tucano dentro do seu agente

O Tucano fala Model Context Protocol nativamente — sem Node, sem npx. Ligue a bridge MCP e plugue Claude Desktop, Claude Code, Cursor, OpenCode ou Codex direto pra inspecionar, refazer e compor requisições.

Pegue o token em Configurações → MCP do app.

Ver documentação →

Ferramentas expostas

tucano_status

Status da bridge + proxy e contagem de flows. Sem parâmetros.

tucano_list_flows

Lista resumos dos flows capturados (sem bodies). Params: limit (1–1000), host, method, status, q, since (epoch-ms pra polling incremental).

tucano_get_flow

Flow completo, com bodies. Params: id.

tucano_get_request_body

Body da request decodificado (utf8 ou base64). Params: id.

tucano_get_response_body

Body da response decodificado (utf8 ou base64). Params: id.

tucano_replay_flow

Re-dispara um flow com overrides opcionais de headers/body; cria flow novo. Params: id, headers (substitui todos quando informado), body.

tucano_compose_request

Envia uma request nova pelo Tucano. Params: method, url (URL completa), headers, body, log (padrão true — false roda sem persistir).

tucano_delete_flows

Apaga flows por id. Params: ids (array).

tucano_clear_flows

Limpa todos os flows capturados — útil pra estabelecer baseline antes de uma automação. Sem parâmetros.

tucano_start_capture

Liga o proxy local e flipa o system proxy do OS pra o tráfego passar pelo Tucano. Params: port (opcional, padrão = porta atual, normalmente 8888).

Perguntas frequentes

Tirando as dúvidas

Preciso instalar um certificado? +

Sim, para inspecionar HTTPS. O Tucano gera um CA local e te guia na instalação. Você pode revogar a qualquer momento.

Funciona offline? +

Funciona. O proxy roda 100% local e não envia dados pra lugar nenhum.

Como é em comparação ao Fiddler ou Proxyman? +

Mesma ideia, com foco em velocidade, simplicidade e ser open source. Sem licença, sem telemetria.

Tem versão para Linux? +

Tem sim — AppImage e .deb na página de download.

Posso contribuir? +

Por favor! Abra uma issue ou um PR no GitHub.

Pronto pra começar?

Escolha o instalador para o seu sistema. MIT. Bugs, ideias e PRs bem-vindos.

Baixar última versão v0.2.4Ver no GitHub