Skip to content

Installation

Prerequisites

Before installing MCPOmni Connect, ensure you have the following:

System Requirements

  • Python 3.10+ (Python 3.11+ recommended)
  • LLM API key from any supported provider
  • UV package manager (recommended) or pip
  • Redis server (optional, for persistent memory)

Check Python Version

python --version
# Should show Python 3.10.0 or higher

UV is the fastest Python package manager and is recommended for MCPOmni Connect:

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

pip install uv

Installation Methods

uv add mcpomni-connect

Method 2: pip

pip install mcpomni-connect

Method 3: From Source

For development or latest features:

git clone https://github.com/Abiorh001/mcp_omni_connect.git
cd mcp_omni_connect
uv sync

Verify Installation

After installation, verify MCPOmni Connect is correctly installed:

mcpomni_connect --version

You should see the version number displayed.

Optional Dependencies

Redis (For Persistent Memory)

MCPOmni Connect can use Redis for persistent conversation memory:

sudo apt update
sudo apt install redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server

brew install redis
brew services start redis

Download from Redis Windows releases or use WSL with Linux instructions.

docker run -d --name redis -p 6379:6379 redis:alpine

Verify Redis Connection

redis-cli ping
# Should respond with: PONG

Next Steps

Once installation is complete:

  1. Set up configuration - Create your .env and servers_config.json files
  2. Follow the Quick Start guide - Get your first MCP connection working
  3. Explore operation modes - Learn about chat, autonomous, and orchestrator modes

Troubleshooting Installation

Common Issues

Python Version Error

Error: MCPOmni Connect requires Python 3.10+

Solution: Upgrade your Python version: 

# Check available Python versions
python3.10 --version  # or python3.11, python3.12

# Use specific Python version with UV
uv python install 3.11
uv add mcpomni-connect

Permission Denied

Error: Permission denied during installation

Solution: Use user installation: 

pip install --user mcpomni-connect

Command Not Found

Error: mcpomni_connect: command not found

Solution: Add to PATH or use full path: 

# Check installation path
pip show mcpomni-connect

# Or run with python -m
python -m mcpomni_connect

Getting Help

If you encounter issues:

  1. Check the troubleshooting guide
  2. Search existing issues
  3. Create a new issue with:
  4. Your operating system
  5. Python version
  6. Installation method used
  7. Complete error message

Next: Quick Start Guide →