H0wZy/mcp

##o_problema

Os principais CLIs de IA (Claude Code, OpenAI Codex, Google Antigravity) operam isolados com configuracoes separadas, duplicacao de boilerplate stdio JSON-RPC, falhas de path no Windows e zero colaboracao cruzada entre modelos.

##o_que_faz

• Nucleo compartilhado DRY (@h0wzy/mcp-shared): motor generico JSON-RPC 2.0 stdio gerenciando handshake, ciclo de vida e captura de erros.
• Execucao cross-platform nativa com resolucao automatica de PATHEXT (.exe, .cmd, .bat) e delimitadores, eliminando bugs no Windows.
• CLI nativo em Go sub-50ms (hmcp / h0wzy-mcp) com TUI interativa em Bubble Tea, diagnosticos de ambiente e zero latencia de rede npx.
• Tratamento resiliente de rate limits e cotas: intercepta HTTP 429 e ResourceExhausted com fallback estruturado sem derrubar a sessao.
• Bridges desacopladas para Claude Code, OpenAI Codex (GPT-5.6 / GPT-6 Astra) e Google Antigravity (Gemini 3.1 Pro / Flash).
• Distribuido via npm (npx @h0wzy/mcp) e binarios avulsos pre-compilados sem dependencias para Windows, Linux e macOS.

##stack

##medido

Commits

32historico git, 19/09/2026 a 21/09/2026

Versao lancada

v1.0.3registro npm e GitHub Releases

Agentes suportados

3Claude Code, OpenAI Codex, Google Antigravity

##como_foi_construido

Projetado com metodologia Spec Kit em specs/001-multi-agent-mcp-hub com diagramas formais de arquitetura, suite de testes e auditorias de seguranca.

Arquitetura monorepo separando o CLI Go em Bubble Tea (cli/), bridges dos hosts (servers/), nucleo reutilizavel JSON-RPC (shared/) e wrapper npm (npm/).

Auditoria de seguranca abrangente (SECURITY_AUDIT.md) garantindo zero vazamento de credenciais, sanitizacao de tokens e isolamento de processos.

Matriz de CI em GitHub Actions validando compilacoes no Windows, Linux e macOS, com geracao automatizada de binarios via GoReleaser.

##limitacoes_conhecidas

• O transporte atual e stdio JSON-RPC 2.0; transporte remoto de rede sobre SSE e streamable HTTP esta planejado na spec 004.
• A deteccao local de CLIs requer que os binarios dos hosts (claude, codex, agy) estejam instalados e disponiveis no PATH.
• A verificacao de updates em background depende da API de Releases do GitHub e degrada de forma limpa quando offline.

##roadmap

• v1.0 hub multi-agente stdio (concluido)
• v1.1 diagnostico interativo TUI doctor e gerenciador de configs (concluido)
• v1.2 distribuicao automatizada de binarios via GoReleaser e npx (concluido)
• v2.0 endpoint remoto SSE / Streamable HTTP via Cloudflare Tunnel: em desenho (spec 004)

##tempo de código rastreado

3 hrs 50 mins Fonte: WakaTime · rastreado desde 2026-03-17 até agora

##links

• GitHub
• Showcase