k5n-mcp-hub is a small, local-first control plane for the Model Context Protocol (MCP) servers you build and run on your own machine. It bundles a registry, reverse proxy, request tracing, health monitoring, capability discovery, fault injection, and an admin UI into a single Python/FastAPI app — no Postgres, Redis, or Kubernetes required.
What it does
- Registry — register MCP servers and discover their tools, prompts, and resources
- Reverse proxy / gateway — route MCP calls (including streaming/SSE) through one endpoint
- Health monitoring — background checks with configurable intervals and failure thresholds
- Request tracing — capture request/response traffic with sensitive-header redaction
- Capability & handshake inspection plus a JSON-RPC playground
- Fault injection — deliberately make a server misbehave (dropped streams, timeouts, malformed JSON, invalid methods) to test how your client copes
- Admin web UI for all of the above
Quality is gated by Ruff, mypy, and an 888-test pytest suite at roughly 83% coverage, running in GitHub Actions. Released under the MIT license.
Learn more: my blog post on k5n-mcp-hub · GitHub.