Release v1.0.9 - Performance & Infrastructure Optimization

January 2026

Major Features

Multi-stage Docker Builds & Image Optimization

Dramatically reduced Docker image sizes and improved build performance:

Registry Image: Reduced from 4.79GB to 1.64GB (66% reduction)
mcpgw Server: Reduced from 7.78GB to ~1.5GB (80% reduction)
Build Context: Optimized from 1.77GB to <500MB
Multi-stage Architecture: 3-stage builds (frontend → backend → runtime)
CPU-only PyTorch: Using PyTorch 2.0+ CPU wheels instead of GPU versions
Selective File Copying: Only necessary application files in final images

PR #333

MongoDB/DocumentDB Storage Backend

Complete migration from file-based storage to production-ready database backends:

DocumentDB Support: AWS DocumentDB for production deployments
MongoDB CE Support: MongoDB Community Edition for local development
Repository Pattern: Abstracted data access layer for flexibility
Factory Pattern: Dynamic backend selection via configuration
Backward Compatibility: File-based storage deprecated but still supported

PR #328

Test Suite Optimization

Comprehensive pytest test suite with dramatic performance improvements:

Performance: Reduced test execution time from 150s to 30s (80% improvement)
Parallel Execution: 8 parallel workers with pytest-xdist
Test Coverage: 701+ tests (unit, integration, E2E)
GitHub Actions: Automated testing on all PRs
Memory Optimization: Smart test ordering to prevent OOM on EC2

PR #330

What's New

Infrastructure & Performance

Multi-stage Docker builds for all images
Optimized .dockerignore to exclude unnecessary files
CPU-only PyTorch installation to reduce image bloat
Comprehensive test suite with 35% minimum coverage
Enhanced testing documentation (Testing Guide)

Storage Backend

DocumentDB primary storage backend for production
MongoDB CE support for local development
Repository pattern for clean data access abstraction
Factory-based backend selection
Removed OpenSearch dependencies

Security & Authentication

Random admin username/password generation for improved security (#325)
Cookie security enhancements (#276)
Domain cookie support for auth-server (#258)
Bitnami Keycloak OCI repository migration (#318)

Developer Experience

Updated llms.txt with critical documentation for AI assistants (#331)
Removed outdated quick-start.md documentation
Enhanced database abstraction layer documentation
Podman rootless macOS support (#308)
Improved ECS architecture diagrams

Frontend Fixes

Fixed frontend authentication issues (#309)
JWT token generation improvements (#307)
Service sidebar filtering fixes (#306)
A2A agents included in statistics panel (#305)
Removed agentsLoading state duplication
Proper server and agent separation in useServerStats

Deployment

GATEWAY_ADDITIONAL_SERVER_NAMES support for nginx (#320)
Ingress port switching improvements
NAT gateway IP configuration for Keycloak ALB
ECS deployment cleanup and image preservation
Enhanced Kubernetes/Helm deployment documentation

Breaking Changes

Storage Backend Migration

Action Required: If you're upgrading from v1.0.8 or earlier, you need to migrate from file-based storage to MongoDB/DocumentDB:

Set storage backend in your .env:

# For production (AWS DocumentDB)
STORAGE_BACKEND=documentdb
DOCUMENTDB_URI=mongodb://username:password@cluster.amazonaws.com:27017/?tls=true&retryWrites=false

# For local development (MongoDB CE)
STORAGE_BACKEND=mongodb
MONGODB_URI=mongodb://localhost:27017/

Data migration: File-based data is not automatically migrated. Re-register servers and agents or use the migration script.

Upgrade Instructions

For Docker Compose Deployments

Pull the latest changes:

cd mcp-gateway-registry
git pull origin main
git checkout v1.0.9

Update environment configuration:

# Add storage backend configuration
echo "STORAGE_BACKEND=mongodb" >> .env
echo "MONGODB_URI=mongodb://localhost:27017/" >> .env

# Optional: Remove file-based storage (deprecated)
# STORAGE_TYPE=file  # Remove this line

Rebuild and restart:

./build_and_run.sh

For AWS ECS Deployment

Update Terraform variables:

# In terraform.tfvars
storage_backend = "documentdb"

Apply Terraform changes:

cd terraform/aws-ecs
terraform init
terraform plan
terraform apply

Rebuild and push optimized images:

export AWS_REGION=us-east-1
make build-push

Testing the Upgrade

Verify all components are working:

# Run E2E tests
./api/test-management-api-e2e.sh --token-file .oauth-tokens/ingress.json --registry-url http://localhost

# Check image sizes
docker images | grep mcp-gateway-registry

# Run pytest suite
make test

Performance Improvements

Docker Build & Deployment

66-80% smaller images: Faster deployments and reduced storage costs
<500MB build context: Much faster Docker builds
Layer reuse: Better Docker layer caching

Test Execution

80% faster tests: From 150s to 30s execution time
Parallel execution: 8 workers for faster CI/CD
Memory efficient: No more OOM crashes on EC2

Storage Backend

Database-backed storage: Better scalability and reliability
Production-ready: DocumentDB with Multi-AZ support
Local development: Fast MongoDB CE for testing

Resources

New Documentation

Testing Guide - Comprehensive testing documentation
Writing Tests - How to write effective tests
Test Maintenance - Maintaining test suite health
Database Abstraction Layer - Storage backend architecture

Updated Documentation

AWS ECS Deployment Guide
LLMs.txt - AI assistant reference documentation
Podman Setup - Podman rootless macOS support

Migration Guides

Storage Backend Migration (TBD - contact maintainers for assistance)

Support

Contributors

Special thanks to all contributors who made this release possible:

@aarora79 (Amit Arora) - MongoDB/DocumentDB storage backend implementation
@dheerajoruganty - Test suite optimization and performance improvements
@omrishiv - Multi-stage Docker build implementation
Gabriel Rojas - Frontend authentication fixes and improvements
Viviana Luccioli - Security enhancements and cookie improvements
dependabot[bot] - Dependency updates and security patches
All community members who reported issues and provided feedback

Full Changelog: v1.0.8...v1.0.9

What's Changed

Update registry deployment to include keycloak M2M by @omrishiv in #300
Fix: Include A2A agents in Statistics panel counts by @viviluccioli in #305
Fix/filter services sidebar 287 by @viviluccioli in #306
Fix/jwt token generation 259 by @viviluccioli in #307
Fix: Frontend bugs and authentication issues from PRs #305, #306, #307 by @aarora79 in #309
Add Podman rootless macOS support by @gabrielrojasnyc in #308
Edited Podman documentation, enhancing PR #308 by @viviluccioli in #314
Fix registry nginx config by @omrishiv in #320
Use oci repository for bitnami keycloak by @omrishiv in #318
Datastore Abstraction Layer with DocumentDB and MongoDB CE Support by @aarora79 in #328
Randomly set admin username/password for registry by @omrishiv in #325
Optimize test suite performance from 150s to 30s by @aarora79 in #330
Update llms.txt with Phase 1 critical documentation gaps (5/11 complete) by @aarora79 in #331
Bump qs and express in /frontend by @dependabot[bot] in #326
Multi-stage Docker builds: Reduce image sizes by 66-80% by @aarora79 in #333

New Contributors

@viviluccioli made their first contribution in #305
@gabrielrojasnyc made their first contribution in #308
@dependabot[bot] made their first contribution in #326

Full Changelog: v1.0.8...v1.0.9

agentic-community/mcp-gateway-registry v1.0.9 Performance & Infrastructure Optimization (DocumentDB, Dockerfile)) on GitHub

Release v1.0.9 - Performance & Infrastructure Optimization

Major Features

Multi-stage Docker Builds & Image Optimization

MongoDB/DocumentDB Storage Backend

Test Suite Optimization

What's New

Infrastructure & Performance

Storage Backend

Security & Authentication

Developer Experience

Frontend Fixes

Deployment

Breaking Changes

Storage Backend Migration

Upgrade Instructions

For Docker Compose Deployments

For AWS ECS Deployment

Testing the Upgrade

Performance Improvements

Docker Build & Deployment

Test Execution

Storage Backend

Resources

New Documentation

Updated Documentation

Migration Guides

Support

Contributors

What's Changed

New Contributors

agentic-community/mcp-gateway-registry v1.0.9
Performance & Infrastructure Optimization (DocumentDB, Dockerfile))

on GitHub