Tucano Proxy

Inspecciona tu tráfico HTTP sin dolor

Un proxy de depuración local, libre y ligero. Captura, filtra y analiza miles de peticiones con una interfaz que no se traba.

Descargar última versión v0.2.3 Ver docs

Qué viene dentro

Todo lo que necesitas para depurar HTTP.

Sin configuración manual, sin bloqueos, sin telemetría. Local de principio a fin.

MITM en 127.0.0.1:8888

Proxy local con TLS reescrito de extremo a extremo usando una CA generada en tu máquina.

Conmutador del proxy del sistema

Activa y desactiva el proxy de macOS y Windows con un clic. Sin editar configuración a mano.

Certificado raíz autofirmado

Generación e instalación guiadas. Tú decides cuándo confiar — y cuándo revocar.

Lista virtualizada

Aguanta decenas de miles de peticiones sin trabarse. Desplazamiento suave de principio a fin.

Filtro con DSL

Filtros potentes. Combina, invierte, guarda.

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

Sesiones .tucano

Guarda todo en un archivo SQLite. Compártelo con tu equipo, ábrelo después, sin perder nada.

Por dentro de la app

Capturas reales — no maquetas.

Bajo el capó

Rendimiento, ligereza y propósito.

Pensado para ser rápido en cualquier máquina, escrito en Rust + Tauri, con diseño minimalista y construido con mucho cariño para ayudar a la comunidad.

↯

De verdad performante

Lista virtualizada, parsing en hilo separado, zero-copy donde se puede. Aguanta miles de requests sin trabar la interfaz.

⌘

Rust + Tauri

Núcleo del proxy en Rust — memoria segura, sin GC, binario pequeño. UI nativa vía Tauri 2.

◇

Diseño minimalista

Cada píxel pensado para desaparecer bajo el contenido. Color con propósito, tipografía generosa, sin adornos.

~10MB

Tamaño del binario

50k+

Requests por sesión

0₵

Siempre gratis

Diferencial

Exportación Markdown lista para LLM

Un clic y Tucano genera un Markdown limpio con prompt personalizable y pasos estructurados — para pegarlo directo en Claude, GPT o cualquier agente que te ayude a depurar.

Prompt personalizable + lenguaje objetivo. Elige C#, TypeScript, Python, Go, Java o libre — el prompt por defecto pide al modelo seguir el patrón ya usado en tu repo.
Pasos estructurados con placeholders. Headers sensibles enmascarados, placeholders cross-step ({var1}, {var2}) y pistas de locator (XPath/JSON-path) para la extracción.
Copia o guarda como .md. Copia al portapapeles o guarda como tucano.llm.md. Texto plano, listo para pegar.

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}  |

claude_desktop_config.json

{
  "mcpServers": {
    "tucano": {
      "command": "npx",
      "args": ["-y", "tucano-mcp"],
      "env": {
        "TUCANO_TOKEN": "paste-token-here"
      }
    }
  }
}

Nuevo · MCP

Tucano dentro de tu agente

El paquete tucano-mcp expone los flujos capturados a través del Model Context Protocol — conéctalo a Claude Desktop, Claude Code, Cursor o cualquier cliente MCP y deja que el agente inspeccione, repita y componga peticiones.

Copia el token en Ajustes → MCP dentro de la app.

Ver documentación →

Herramientas expuestas

tucano_status

Estado del bridge + proxy y conteo de flows. Sin parámetros.

tucano_list_flows

Lista resúmenes de flows capturados (sin bodies). Params: limit (1–1000), host, method, status, q, since (epoch-ms para polling incremental).

tucano_get_flow

Flow completo, con bodies. Params: id.

tucano_get_request_body

Body de la request decodificado (utf8 o base64). Params: id.

tucano_get_response_body

Body de la response decodificado (utf8 o base64). Params: id.

tucano_replay_flow

Re-ejecuta un flow con overrides opcionales de headers/body; crea un flow nuevo. Params: id, headers (reemplaza todos cuando se indica), body.

tucano_compose_request

Envía una request nueva por Tucano. Params: method, url (URL completa), headers, body, log (por defecto true — false ejecuta sin persistir).

tucano_delete_flows

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

tucano_clear_flows

Borra todos los flows capturados — útil para establecer baseline antes de una automatización. Sin parámetros.

tucano_start_capture

Inicia el proxy local y activa el system proxy del SO para que el tráfico pase por Tucano. Params: port (opcional, por defecto = puerto actual, normalmente 8888).

Preguntas frecuentes

Resolviendo dudas

¿Necesito instalar un certificado? +

Sí, para inspeccionar HTTPS. Tucano genera una CA local y te guía en la instalación. Puedes revocarla cuando quieras.

¿Funciona sin conexión? +

Sí. El proxy corre 100% local y no envía datos a ningún sitio.

¿Cómo se compara con Fiddler o Proxyman? +

Misma idea, enfocado en velocidad, simplicidad y código abierto. Sin licencia, sin telemetría.

¿Hay versión para Linux? +

Sí — AppImage y .deb disponibles en la página de descarga.

¿Puedo contribuir? +

¡Por favor! Abre un issue o PR en GitHub.

¿Listo para empezar?

Elige el instalador para tu sistema. MIT. Bugs, ideas y PRs bienvenidos.

Descargar última versión v0.2.3 Ver en GitHub