Installation¶

Requirements¶

Python 3.11 or higher
Docker or Podman (for container MCP servers)

Quick Install (Recommended)¶

curl -sSL https://mcp-hangar.io/install.sh | bash

This will install the latest version of MCP Hangar and set up your environment.

Install from PyPI¶

pip install mcp-hangar

Install from Source (Monorepo)¶

MCP Hangar is organized as a monorepo:

mcp-hangar/
├── src/mcp_hangar/     # Python package (PyPI: mcp-hangar)

Python Core Package¶

git clone https://github.com/mcp-hangar/mcp-hangar.git
cd mcp-hangar
pip install -e .

Development Installation¶

git clone https://github.com/mcp-hangar/mcp-hangar.git
cd mcp-hangar

# Install with dev dependencies
pip install -e ".[dev]"

# Or use uv from root
make setup

Docker¶

docker pull ghcr.io/mcp-hangar/mcp-hangar:1.1.0

# Run with config
docker run -v $(pwd)/config.yaml:/app/config.yaml:ro \
  ghcr.io/mcp-hangar/mcp-hangar:1.1.0

Verify Installation¶

mcp-hangar --version