ARC Config MCP Server

# 🚀 ARC MCP Server v2.1.0 Release Notes ## 🎯 **Major Enhancements** ### ✨ **Enhanced Parameter Handling** - ✅ **Added proper MCP `inputSchema`** with Zod validation to all tools - ✅ **Fixed parameter processing** for replicas, organization, runnerName - ✅ **Successfully tested** with 16-runner deployment - ✅ **Resolved parameter handling regression** from v2.0.0 **Impact**: Users can now specify custom replica counts, organization names, and runner configurations that are properly processed by the MCP server. ### 🧠 **Intelligent Organization Auto-Detection** - ✅ **Auto-detects working GitHub organizations** from existing deployments - ✅ **Prevents 404 GitHub API errors** from invalid organization names - ✅ **Intelligent fallback** to known working organizations - ✅ **Seamless organization management** without user intervention **Impact**: Eliminates organization access errors that previously caused deployment failures. The system now automatically finds and uses accessible organizations. ### 🛡️ **Enhanced Error Handling & Recovery** - ✅ **Detects GitHub 404 organization access errors** with specific guidance - ✅ **Provides step-by-step recovery instructions** for common issues - ✅ **Enhanced error messages** with actionable remediation steps - ✅ **Suggests auto-detection and fallback options** **Impact**: Users receive clear guidance when errors occur, with specific steps to resolve common GitHub API and organization access issues. ### ⚡ **Reliability & Stability Improvements** - ✅ **Fixed `toLowerCase()` null reference errors** in status helpers - ✅ **Added comprehensive null safety checks** throughout - ✅ **Enhanced runner status collection** with pod information - ✅ **Improved MCP tool stability** and error resilience **Impact**: Significantly improved stability and eliminated runtime errors that could crash MCP tools. ## 🎯 **Real-World Performance Results** | Metric | v2.1.0 Performance | Improvement | |--------|-------------------|-------------| | **Fresh ARC Installation** | 91.9 seconds (< 1.5 minutes) | ✅ Consistent | | **16-Runner Deployment** | 3 seconds with intelligent auto-scaling | ✅ Now Working | | **Organization Auto-Detection** | Seamless fallback to working org | 🆕 **New Feature** | | **Parameter Handling** | Perfect processing of custom configurations | 🔧 **Fixed** | | **Error Recovery** | Clear guidance for common GitHub API issues | 🆕 **Enhanced** | ## 🔧 **Technical Implementation Details** ### **Parameter Schema Enhancements** All MCP tools now include proper `inputSchema` definitions: - **`arc_deploy_runners`**: `organization`, `replicas`, `runnerName`, `namespace` - **`arc_manage_runners`**: `action`, `namespace`, `replicas`, `runnerName` - **`arc_scale_runners`**: `replicas` (required), `runnerName`, `namespace` - **`arc_install_controller`**: `namespace`, `version`, `enableRealTimeLogging` - **All tools**: Proper inputSchema with Zod type validation ### **Organization Auto-Detection Logic** 1. ✅ Check provided organization parameter 2. ✅ Fallback to `GITHUB_ORG` environment variable 3. ✅ Auto-detect from existing runner deployments 4. ✅ Final fallback to known working organization (`tsvi-solutions`) 5. ✅ Provide recovery guidance if GitHub API access fails ### **Error Handling Improvements** - ✅ Pattern matching for GitHub 404 organization errors - ✅ Specific recovery steps for token configuration issues - ✅ Auto-detection suggestions for organization access problems - ✅ Enhanced error messages with contextual guidance ## 🏆 **Before vs After Comparison** ### **❌ Before v2.1.0:** ```bash # Parameter handling was broken arc_deploy_runners(replicas=15) → returned 3 runners (default) # Organization errors caused failures arc_deploy_runners(organization="tsviz") → 404 GitHub API error # Cryptic error messages "Cannot read properties of undefined (reading 'toLowerCase')" ``` ### **✅ After v2.1.0:** ```bash # Parameters work perfectly arc_deploy_runners(replicas=16) → deploys exactly 16 runners # Auto-detection prevents errors arc_deploy_runners() → auto-detects "tsvi-solutions" and succeeds # Clear error guidance "❌ GitHub Organization Access Error The organization 'tsviz' is not accessible... 💡 Tip: Run without organization to auto-detect" ``` ## 🚀 **Migration & Upgrade Guide** ### **No Breaking Changes** - ✅ **Backward Compatible**: Existing configurations continue to work - ✅ **Enhanced Defaults**: Better parameter handling and error recovery - ✅ **Improved Experience**: No configuration changes required ### **Recommended Actions** 1. ✅ **Update to v2.1.0** for improved stability and user experience 2. ✅ **Test parameter handling** with custom replica counts and names 3. ✅ **Leverage auto-detection** by omitting organization parameter when unsure 4. ✅ **Review enhanced error messages** for better troubleshooting ## 🎯 **What's Fixed & Enhanced** ### **🔧 Fixed Issues:** - **Parameter Processing**: MCP tools now properly receive and process parameters - **Organization Access**: Auto-detection prevents 404 GitHub API errors - **Runtime Errors**: Eliminated `toLowerCase()` null reference exceptions - **Error Messages**: Clear guidance instead of cryptic technical errors ### **🆕 New Features:** - **Organization Auto-Detection**: Intelligent discovery of accessible organizations - **Enhanced Error Handling**: Specific recovery guidance for common issues - **Parameter Validation**: Zod schema validation for type safety - **Null Safety**: Comprehensive null checking throughout the codebase ### **⚡ Performance & Reliability:** - **3-second deployments** for custom runner configurations - **91.9-second installations** with comprehensive progress updates - **Zero parameter handling failures** in testing - **Seamless organization fallback** without user intervention ## 🏁 **Summary** **v2.1.0** represents a significant improvement in **reliability**, **user experience**, and **robustness** of the ARC MCP Server. The enhanced parameter handling and organization auto-detection eliminate the most common sources of user frustration and deployment failures. ### **Key Takeaways:** - 🎯 **Parameter handling now works perfectly** - deploy exactly what you specify - 🧠 **Organization auto-detection** prevents GitHub API access errors - 🛡️ **Enhanced error messages** provide clear recovery guidance - ⚡ **Improved stability** with comprehensive null safety checks This is a **recommended upgrade** for all users seeking improved stability and user experience. --- **Release Date**: October 7, 2025 **Git Tag**: `v2.1.0` **Commit**: `7708f65` **Docker Image**: `ghcr.io/tsviz/arc-config-mcp:v2.1.0`