Release v1.0.14 - Registry-Only Deployment Mode

Release v1.0.14 - Registry-Only Deployment Mode

February 2026

Major Features

Registry-Only Deployment Mode

Deploy the registry as a standalone catalog/discovery service without gateway integration:

• New DEPLOYMENT_MODE parameter: Choose between with-gateway (default) or registry-only
• Works with REGISTRY_MODE: Combine deployment mode with registry mode (full, skills-only, mcp-servers-only, agents-only)
• Lightweight deployments: Run registry without nginx dynamic location block generation for catalog-only use cases
• Auto-correction: Invalid combinations (e.g., with-gateway + skills-only) are automatically corrected with warnings
• Prometheus metrics: Monitor deployment mode via registry_deployment_mode_info gauge and track skipped nginx updates via registry_nginx_updates_skipped_total counter
• Health check enhancement: /health endpoint now includes deployment_mode, registry_mode, and nginx_updates_enabled fields
• Configuration API: New /api/config endpoint exposes deployment mode and feature flags to the frontend
• Frontend awareness: UI adapts to deployment mode — shows direct server URLs and hides gateway auth instructions in registry-only mode

PR #478

Configuration

Environment Variables

# Deployment mode: with-gateway (default) or registry-only
DEPLOYMENT_MODE=with-gateway

# Registry mode: full (default), skills-only, mcp-servers-only, agents-only
REGISTRY_MODE=full

Example: Skills-Only Registry

DEPLOYMENT_MODE=registry-only
REGISTRY_MODE=skills-only

Auto-Correction Behavior

If an invalid combination is detected at startup, the registry auto-corrects and logs a warning banner:

All other combinations are valid and pass through unchanged.

Helm Chart

registry:
  deployment_mode: with-gateway
  registry_mode: full

Terraform

deployment_mode = "with-gateway"
registry_mode   = "full"

What's Changed

• New DeploymentMode and RegistryMode enums in configuration
• nginx_updates_enabled property on Settings controls nginx behavior
• Nginx service methods (generate_config, generate_config_async, reload_nginx) return early in registry-only mode
• Prometheus metrics for deployment mode info and skipped nginx operations
• /api/config endpoint for frontend deployment mode awareness
• /health endpoint enhanced with deployment mode fields
• Docker entrypoint logs deployment mode at container startup
• useRegistryConfig React hook for frontend components
• DeploymentModeIndicator badge component for registry-only mode
• ServerConfigModal uses proxy_pass_url in registry-only mode instead of constructed gateway URL
• Helm chart, Terraform, and .env.example updated with new variables

Upgrade Instructions

For Docker Compose Deployments

1. Pull the latest changes:

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

2. Rebuild and restart:

./build_and_run.sh

No configuration changes required — defaults to with-gateway + full for backward compatibility.

For Kubernetes/Helm Deployments

1. Update chart values if you want registry-only mode:

registry:
  deployment_mode: registry-only
  registry_mode: skills-only  # or full, mcp-servers-only, agents-only

2. Apply changes:

helm upgrade mcp-gateway ./charts/mcp-gateway -f your-values.yaml

Support

• GitHub Issues
• GitHub Discussions
• Documentation

Full Changelog: v1.0.13...v1.0.14