pr33th4m/l1mbo repository overview

⁠Limbo - MCP Aggregator

Give your AI assistant extra limbs! Limbo is a meta-MCP server that dynamically aggregates multiple Model Context Protocol servers into one unified interface.

⁠What is Limbo?

Limbo lets AI assistants install and manage their own tools on-demand without restarting. Instead of manually configuring 10+ MCP servers, configure Limbo once and let your AI extend its capabilities as needed.

⁠Features

• 🔥 Dynamic Tool Loading - Add/remove MCP servers without restart
• 🤖 AI-Driven - Your AI can discover and install tools autonomously
• 🎯 Tool Prefixing - Prevent naming conflicts between servers
• 🔄 Auto-Reload - Config changes apply instantly
• 🔐 JWT Authentication - Optional security layer
• 📦 Kit System - Bundle related servers for easy management
• 🐳 Docker Ready - Production-ready containerization

⁠Quick Start

# Pull the image
docker pull pr3th4m/limbo:latest

# Run in HTTP mode
docker run -p 8000:8000 pr3th4m/limbo:latest

# Run with persistent config
docker run -p 8000:8000 -v limbo-config:/home/limbo/.limbo pr3th4m/limbo:latest

⁠Use with Docker MCP Gateway

# Download catalog
curl -O https://raw.githubusercontent.com/Pritz395/limbo/main/limbo-catalog.yaml

# Add to Docker MCP
docker mcp catalog create custom
docker mcp catalog add custom limbo ./limbo-catalog.yaml
docker mcp server enable limbo

⁠Available Commands

• limbo serve - Start server (stdio/HTTP/hybrid)
• limbo server add/remove/list - Manage MCP servers
• limbo kit load/list - Manage server bundles
• limbo auth init - Setup authentication

⁠Configuration

Limbo stores config in .limbo/config.json with auto-reload support. Control via environment variables:

• LIMBO_LOG_LEVEL - Logging level (default: INFO)
• LIMBO_AUTO_RELOAD - Enable config hot-reload (default: true)
• LIMBO_SELF_PREFIX - Tool prefix (default: "limbo")

⁠MCP Tools

When connected to your AI, Limbo provides management tools:

• limbo_add_server - Dynamically add MCP servers
• limbo_list_servers - View configured servers
• limbo_status - Health check and statistics
• And 13 more management tools!

⁠Example Use Case

You: "I need filesystem access" AI: calls limbo_add_server(name="filesystem", command="npx -y @modelcontextprotocol/server-filesystem") You: Now have filesystem tools instantly!