🚀 AIRIS MCP Gateway v1.0.0

First stable release with complete MCP server state persistence system.

✅ Features

Core Functionality

• 25 MCP Servers Integrated: filesystem, context7, serena, mindbase, tavily, supabase, and more
• Multi-Editor Support: Claude Code, Claude Desktop, Cursor, Zed, Windsurf
• Zero-Token Startup: IDE recognizes only Gateway URL, tool definitions loaded on-demand
• Docker-First Architecture: All servers run in containers, Mac host stays clean

State Persistence System 🆕

• MCP Server ON/OFF State Persistence: Settings saved to PostgreSQL database
• Automatic State Restoration: UI loads saved states on page load
• Real-time Synchronization: Toggle changes instantly saved and reflected

Security & Configuration

• Docker Secrets Integration: Encrypted API key storage
• PostgreSQL Backend: Secure configuration and state management
• Settings UI: Web-based management interface (http://localhost:5173)
• FastAPI Backend: REST API for server management (http://localhost:8001)

Profile System

• Recommended Profile: Long-term projects with memory + learning (mindbase, serena)
• Minimal Profile: Lightweight for quick tasks (~50MB)
• Custom Profile: Flexible server combinations for specialized workflows

Multi-Project Support

• Unified Configuration: Single mcp.json symlinked across all projects
• Persistent Gateway: Stays running when switching projects
• Cross-Editor Consistency: Same toolset everywhere

📦 Installation

git clone https://github.com/agiletec-inc/airis-mcp-gateway.git ~/github/airis-mcp-gateway
cd ~/github/airis-mcp-gateway
make install

Restart all editors → 25 MCP servers ready everywhere! 🎉

🔧 Quick Start

# Start Gateway
make up

# Access Settings UI
open http://localhost:5173

# Check service status
make ps

# View logs
make logs

📚 Documentation

• README.md - Complete guide
• SECRETS.md - Secret management
• profiles/README.md - Profile system

🐛 Known Issues

None reported yet. Please file issues on GitHub!

🔮 Planned for v1.1

• Performance optimizations
• Additional MCP server integrations
• Enhanced monitoring and logging
• Community-requested features

💖 Support

If this project helps you, consider supporting development:

• ☕ Ko-fi
• 🎯 Patreon
• 💜 GitHub Sponsors

📄 License

MIT License - Free to use commercially

Created by: Agiletec Inc.