SUSE AI Universal Proxy
A comprehensive, modular MCP (Model Context Protocol) proxy system that enables secure, scalable, and extensible AI model integrations.
๐ Key Capabilities
๐ MCP Proxy Service - Full-featured HTTP proxy for MCP servers with advanced session management, authentication, and protocol translation.
๐ Network Discovery - Automated network scanning to discover MCP servers, detect authentication types, and assess security vulnerabilities.
๐ Server Registry - Curated registry of MCP Servers, including GitHub, SUSE MCP's, Atlassian, Gitea, and 20+ other popular services (yes you may contribute to the list!).
๐ Plugin Management - Dynamic plugin system for extending functionality with service registration, health monitoring, and capability routing.
๐ Documentation
- QUICKSTART - Get started quickly with SUSE AI Universal Proxy
- REGISTRY - Learn about MCP server registry management
- SECURITY - Security guidelines and best practices
- AUTHENTICATION - Authentication and authorization options
๐๏ธ Architecture
The system uses a main container + sidecar architecture where services run as coordinated containers within a single Kubernetes pod:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ SUSE AI Universal Proxy โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ UNIFIED SERVICE โ โ
โ โ โ โ
โ โ โข MCP Proxy with session management โ โ
โ โ โข Server registry and discovery โ โ
โ โ โข Plugin management and orchestration โ โ
โ โ โข Authentication and authorization โ โ
โ โ โ โ
โ โ HTTP: 8911 | HTTPS: 3911 โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโ โ
โ โ PLUGINS โ โ
โ โ (External) โ โ
โ โ โ โ
โ โ Variable โ โ
โ โ Ports โ โ
โ โโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐โโ๏ธ Quick Start
Setup SUSE AI Universal Proxy (Helm installation)
- Open a local terminal
- Clone the repository:
https://github.com/suse/suse-ai-up(branch: main) - enter in the folder
suse-ai-up - In values.yaml, set:
service.type: LoadBalancerauth.method: development(for no auth)
Install using the helm chart:
helm install suse-ai-up ./charts/suse-ai-up
- Wait for the installation to be completed
Get Service IP
kubectl get svc suse-ai-up-service -n suse-ai-up -o jsonpath='{.status.loadBalancer.ingress[0].ip}'
(Alternative) Setup SUSE AI Universal Proxy (in Rancher)
- In Rancher, add repository:
https://github.com/suse/suse-ai-up(branch: main) - Go to Apps โ Charts
- Find and install "SUSE AI Universal Proxy"
- Click Install and wait for completion
Setup SUSE AI Universal Proxy UI
- In Rancher, add repository:
https://github.com/suse/suse-ai-up-ext(branch: v0.1.0) - Go to Extensions
- Find and install "SUSE AI Universal Proxy"
Verify Installation and Access Swagger Docs
Access API documentation:
http://{IP ADDRESS}:8911/docs/index.html
Local Development
git clone https://github.com/suse/suse-ai-up.git
cd suse-ai-up
go run ./cmd/uniproxy
Universal Proxy require Kubernets so the ideal development way is to deploy the helm chart in kubernetes
๐ Service Overview
๐ SUSE AI Universal Proxy
- Purpose: Unified MCP proxy service with integrated registry, discovery, and plugin management
- Features:
- MCP protocol proxy with session management
- Integrated server registry and catalog
- Network discovery and automatic server detection
- Plugin orchestration and lifecycle management
- Authentication and authorization
- TLS encryption support
- Ports: HTTP 8911, HTTPS 3911
- Architecture: Single unified service replacing separate microservices
๐ External Plugins
- Purpose: Extensible plugin system for additional MCP server integrations
- Features: External plugin registration, health monitoring, custom MCP server types
- Ports: Variable (configured per plugin)
- Integration: Register with main proxy service via API
๐ Quick Examples
Check the file EXAMPLES.md
๐ค Contributing
We welcome contributions! Please see our Contributing Guide for details.
๐ License
Licensed under the Apache License, Version 2.0. See LICENSE for details.
๐ Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
SUSE AI Universal Proxy - Making AI model integration secure, scalable, and simple.