Pitch: Gerando MCP e OpenAPI automaticamente a partir do tráfego da sua API
Estava explorando como tornar APIs utilizáveis por agentes (MCP) sem precisar fazer todo o trabalho manual de mapear endpoints, definir schema e manter isso atualizado.
O fluxo tradicional normalmente envolve:
- mapear cada endpoint
- definir contratos manualmente
- gerar OpenAPI
- adaptar tudo para uso por agentes
Além de trabalhoso, isso fica desatualizado rápido conforme a API evolui.
A ideia que comecei a explorar foi:
E se fosse possível gerar tudo isso automaticamente a partir do tráfego da API?
Ou seja, em vez de descrever a API manualmente, observar o que já está acontecendo em produção (ou ambiente de dev) e usar isso como fonte de verdade.
O que implementei
Acabei construindo um fluxo que:
- acompanha o tráfego da API (via extensão do chrome ou proxy local)
- identifica padrões de requisições e respostas
- agrupa endpoints e estruturas
- gera automaticamente:
- um MCP utilizável por agentes
- uma especificação OpenAPI para baixar
- uma portal público e navegável da API
Tudo sem precisar mapear endpoints manualmente.
Como funciona (resumo)
- A extensão do Chrome acompanha o tráfego da API durante o uso
- O Dufckly processa e organiza as requisições e respostas
- Os dados são estruturados em padrões reutilizáveis
- O sistema gera automaticamente MCP e OpenAPI a partir disso
- Tudo de forma contínua
Demonstração
Gravei dois vídeos mostrando na prática:
1. Gerando MCP a partir do tráfego da API
https://youtu.be/UpeEs8plD7k
2. Gerando documentação pública automaticamente
https://youtu.be/r4bzWvnGDwA
Se alguém quiser testar:
https://duckfly.dev
Fico aberto a feedback técnico 🙂