🧲 Magg - The MCP Aggregator

A Model Context Protocol server that manages, aggregates, and proxies other MCP servers, enabling LLMs to dynamically extend their own capabilities.

What is Magg?

Magg is a meta-MCP server that acts as a central hub for managing multiple MCP servers. It provides tools that allow LLMs to:

• Search for new MCP servers and discover setup instructions
• Add and configure MCP servers dynamically
• Enable/disable servers on demand
• Aggregate tools from multiple servers under unified prefixes
• Persist configurations across sessions

Think of Magg as a "package manager for LLM tools" - it lets AI assistants install and manage their own capabilities at runtime.

Features

• Self-Service Tool Management: LLMs can search for and add new MCP servers without human intervention.
• Dynamic Configuration Reloading: Automatically detects and applies config changes without restarting.
• Automatic Tool Proxying: Tools from added servers are automatically exposed with configurable prefixes.
• ProxyMCP Tool: A built-in tool that proxies the MCP protocol to itself, for clients that don't support notifications or dynamic tool updates (which is most of them currently).
• Smart Configuration: Uses MCP sampling to intelligently configure servers from just a URL.
• Persistent Configuration: Maintains server configurations in .magg/config.json.
• Multiple Transport Support: Works with stdio, HTTP, and in-memory transports.
• Bearer Token Authentication: Optional RSA-based JWT authentication for secure HTTP access.
• Docker Support: Pre-built images for production, staging, and development workflows.
• Health Monitoring: Built-in magg_status and magg_check tools for server health checks.
• Real-time Messaging: Full support for MCP notifications and messages - receive tool/resource updates and progress notifications from backend servers.
• Python 3.12+ Support: Fully compatible with Python 3.12 and 3.13.
• Kit Management: Bundle related MCP servers into kits for easy loading/unloading as a group.
• MBro CLI: Included MCP Browser for interactive exploration and management of MCP servers, with script support for automation.

Installation

Prerequisites

• Python 3.12 or higher (3.13+ recommended)
• uv (recommended) - Install from astral.sh/uv

Quick Install (Recommended)

The easiest way to install Magg is as a tool using uv:

# Install Magg as a tool
uv tool install magg

# Run with stdio transport (for Claude Desktop, Cline, etc.)
magg serve

# Run with HTTP transport (for system-wide access)
magg serve --http

Alternative: Run Directly from GitHub

You can also run Magg directly from GitHub without installing:

# Run with stdio transport
uvx --from git+https://github.com/sitbon/magg.git magg

# Run with HTTP transport
uvx --from git+https://github.com/sitbon/magg.git magg serve --http

Local Development

For development, clone the repository and install in editable mode:

# Clone the repository
git clone https://github.com/sitbon/magg.git
cd magg

# Install in development mode with dev dependencies
uv sync --dev