Skip to content

🚀 MCPOmni Connect - Universal Gateway to MCP Servers

PyPI Downloads Python Version License Tests PyPI version

New to MCPOmni Connect?

Start with the Installation Guide and Quick Start to get up and running in minutes.

MCPOmni Connect is a powerful, intelligent AI agent system and universal command-line interface (CLI) that goes beyond being just a gateway to the Model Context Protocol (MCP) ecosystem. It acts as an autonomous agent through its ReAct Agent Mode and Orchestrator Mode, capable of independent reasoning, decision-making, and complex task execution.

✨ Key Features

🤖 Intelligent Agent System

  • Autonomous task execution with reasoning and action cycles
  • Independent decision-making without human intervention
  • Advanced problem-solving through iterative reasoning
  • Self-guided tool selection and execution
  • Complex task decomposition and handling
  • Strategic multi-step task planning and execution
  • Intelligent coordination across multiple MCP servers
  • Dynamic agent delegation and communication
  • Parallel task execution when possible
  • Sophisticated workflow management with real-time progress monitoring
  • Human-in-the-loop task execution with approval workflows
  • Step-by-step guidance and explanations
  • Educational mode for understanding AI decision processes

🔌 Universal Connectivity

  • Multi-Protocol Support: stdio, Server-Sent Events (SSE), Streamable HTTP
  • Authentication Support: OAuth 2.0, Bearer tokens, custom headers
  • Container Integration: Docker and NPX package execution
  • Extensible Transport Layer: Future-ready protocol support

🧠 AI-Powered Intelligence

MCPOmni Connect uses LiteLLM for unified access to 100+ AI models across all major providers:

  • OpenAI (GPT-4, GPT-3.5, etc.)
  • Anthropic (Claude 3.5 Sonnet, Claude 3 Haiku, etc.)
  • Google (Gemini Pro, Gemini Flash, etc.)
  • Groq (Llama, Mixtral, Gemma, etc.)
  • DeepSeek (DeepSeek-V3, DeepSeek-Coder, etc.)
  • Azure OpenAI, OpenRouter, Ollama (local models)

🔒 Security & Privacy

  • Explicit User Control: All tool executions require user approval in chat mode
  • Data Protection: Strict access controls and server-specific isolation
  • Privacy-First: Minimal data collection, encrypted transport protocols

💾 Memory Management

  • Redis-Powered Persistence: Long-term conversation memory storage
  • File-Based Chat History: Save and restore complete conversations
  • Intelligent Context Management: Automatic context pruning and retrieval

🏗️ Architecture

graph TB
    A[MCPOmni Connect] --> B[Transport Layer]
    A --> C[Session Management]
    A --> D[Tool Management]
    A --> E[AI Integration]

    B --> B1[Stdio Transport]
    B --> B2[SSE Transport]
    B --> B3[Docker Integration]

    C --> C1[Multi-Server Orchestration]
    C --> C2[Connection Lifecycle]

    D --> D1[Dynamic Tool Discovery]
    D --> D2[Cross-Server Tool Routing]
    D --> D3[Tool Execution Engine]

    E --> E1[LLM Processing]
    E --> E2[Context Management]
    E --> E3[Response Generation]

🚀 Quick Start

Get Started in 3 Steps

  1. Install: uv add mcpomni-connect or pip install mcpomni-connect
  2. Configure: Set up your .env file and servers_config.json
  3. Run: Execute mcpomni_connect to start the CLI

Detailed Installation Guide →

📖 Documentation Structure

  • 🚀 Getting Started

    Installation, quick start, and basic setup instructions

    Get Started

  • ⚙️ Configuration

    Complete configuration guide including transport types and authentication

    Configure

  • 📚 User Guide

    Detailed usage instructions, commands, and operation modes

    Learn

  • 🎯 Features

    Deep dive into agent systems, tool orchestration, and advanced features

    Explore

  • 🔧 Advanced

    Architecture details, API reference, and advanced examples

    Advanced

  • 👨‍💻 Development

    Testing, contributing, and development guidelines

    Contribute

🎯 Use Cases

MCPOmni Connect excels in scenarios requiring:

  • Multi-System Integration: Connect and orchestrate across different MCP servers
  • Autonomous Task Execution: Let AI agents handle complex workflows independently
  • Interactive Development: Build and test MCP integrations with immediate feedback
  • Enterprise Automation: Scale AI-powered automation across organizational tools

📬 Support & Community

Ready to connect your AI to everything? Let's get started! 🚀