Skip to content

MCP Hangar

CI - Core CI - Operator PyPI Python 3.11+ License: MIT Documentation

Production-grade MCP server registry with lazy loading, health monitoring, and container support.

Monorepo Structure

MCP Hangar is a monorepo containing multiple packages:

Package Description Location
Core Python library (PyPI: mcp-hangar) src/mcp_hangar/
Core package MIT-only features src/mcp_hangar/

Features

  • Lazy Loading -- MCP servers start only when invoked, tools visible immediately
  • Container Support -- Docker/Podman with auto-detection
  • MCP Server Groups -- Load balancing with multiple strategies
  • Health Monitoring -- Circuit breaker pattern with automatic recovery
  • Auto-Discovery -- Detect MCP servers from Docker labels, K8s annotations, filesystem
  • REST API -- Full CRUD API for MCP servers, groups, discovery, config, and auth
  • Log Streaming -- Live MCP server logs via REST and WebSocket
  • RBAC -- Role-based access control with tool-level policies
  • Catalog -- Browsable MCP server catalog with search and deploy
  • Automatic Retry -- Built-in retry with exponential backoff for transient failures
  • Real-Time Progress -- See operation progress while waiting
  • Rich Errors -- Human-readable errors with recovery hints
  • Kubernetes Native -- CRDs for declarative MCP server management

Quick Start

30 seconds to working MCP servers:

curl -sSL https://mcp-hangar.io/install.sh | bash && mcp-hangar init -y && mcp-hangar serve

That's it. Restart Claude Desktop and you have filesystem, fetch, and memory MCP servers.

What just happened?

Install - Downloaded and installed mcp-hangar via pip/uv. Init - Created config with starter MCP servers, updated Claude Desktop. Serve - Started the MCP server (stdio mode). The init -y flag uses sensible defaults: detects runtimes (uvx preferred), configures starter bundle (filesystem, fetch, memory), updates Claude Desktop.

Manual Installation

# Install
pip install mcp-hangar

# Interactive setup wizard
mcp-hangar init

# Start server
mcp-hangar serve

HTTP Mode

# Start with REST API
mcp-hangar serve --http --port 8000

# REST API:  http://localhost:8000/api/

Documentation

Contributing

See Contributing Guide for development setup and guidelines.

License

MIT - see LICENSE for details.