h0wzy
  1. Home
  2. All works
  3. H0wZy/mcp
pt

H0wZy/mcp

tooling in production

Multi-agent Model Context Protocol hub and Go CLI bridging Claude Code, OpenAI Codex and Google Antigravity.

2026-09-19 → 2026-09-21 · 32 commits

Interactive Showcase & Live HubAccess the visual preview with TUI, AI bridges, connector widgets and docs.
Open Showcase →

the_problem

Leading AI developer CLIs (Claude Code, OpenAI Codex, Google Antigravity) operate in isolation with separate configurations, duplicate stdio JSON-RPC boilerplate, platform-specific path bugs on Windows, and zero cross-model collaboration.

what_it_does

  • DRY Shared Core (@h0wzy/mcp-shared): generic JSON-RPC 2.0 stdio engine managing 100% of handshake, lifecycle, and error trapping.
  • Native cross-platform execution with automatic PATHEXT resolution (.exe, .cmd, .bat) and delimiter handling, eliminating Windows glitches.
  • Sub-50ms native Go CLI (hmcp / h0wzy-mcp) with interactive Bubble Tea TUI, environment diagnostics, and zero npx network latency.
  • Resilient rate limit and quota handling: traps HTTP 429 and ResourceExhausted limits with structured fallback so host agents never crash.
  • Decoupled bridges for Claude Code, OpenAI Codex (GPT-5.6 / GPT-6 Astra), and Google Antigravity (Gemini 3.1 Pro / Flash).
  • Distributed via npm (npx @h0wzy/mcp) and precompiled zero-dependency standalone binaries for Windows, Linux, and macOS.

stack

backend

Go 1.25 · TypeScript

infra

GitHub Actions

other

Model Context Protocol

measured

Commits
32git history, 2026-09-19 to 2026-09-21
Shipped version
v1.0.3npm registry and GitHub Releases
Supported host agents
3Claude Code, OpenAI Codex, Google Antigravity

how_it_was_built

Designed with Spec Kit methodology under specs/001-multi-agent-mcp-hub with formal architecture diagrams, test suites, and security audits.

Monorepo architecture separating the Go Bubble Tea CLI (cli/), host bridges (servers/), reusable JSON-RPC core (shared/), and npm wrapper (npm/).

Comprehensive security audit (SECURITY_AUDIT.md) ensuring zero secret leakage, token sanitization on error responses, and clean process isolation.

GitHub Actions CI matrix validating builds across Windows, Linux and macOS, with automated GoReleaser standalone binary generation.

known_limitations

  • Transport is currently stdio JSON-RPC 2.0; remote network transport over SSE and streamable HTTP is planned in spec 004.
  • Local CLI detection requires the host binaries (claude, codex, agy) to be installed and available in PATH.
  • Background update detection depends on GitHub Release API availability and degrades cleanly when offline.

roadmap

  • v1.0 multi-agent stdio hub (completed)
  • v1.1 interactive TUI doctor and config manager (completed)
  • v1.2 automated binary distribution via GoReleaser and npx (completed)
  • v2.0 remote SSE / Streamable HTTP endpoint via Cloudflare Tunnel: in design (spec 004)

tracked coding time

3 hrs 50 mins Source: WakaTime · tracked 2026-03-17 to current

← back to all works