Smart Prompts MCP Server

# Feature Comparison: Original vs Enhanced ## 📊 Feature Matrix | Feature | Original prompts-mcp-server | Enhanced smart-prompts-mcp | |---------|---------------------------|---------------------------| | **Storage** | | | | Local file storage | ✅ | ✅ | | GitHub repository storage | ❌ | ✅ | | Private repo support | ❌ | ✅ | | Real-time sync | ❌ | ✅ | | | | | | **Core Operations** | | | | Add prompts | ✅ | ✅ | | Get prompts | ✅ | ✅ | | List prompts | ✅ | ✅ | | Delete prompts | ✅ | ✅ | | | | | | **Search & Discovery** | | | | Basic search | ✅ | ✅ | | Search by category | ❌ | ✅ | | Search by tags | ❌ | ✅ | | Similar prompt suggestions | ❌ | ✅ | | Category listing with counts | ❌ | ✅ | | | | | | **AI Guidance** | | | | Basic tool descriptions | ✅ | ✅ Enhanced | | Workflow guidance | ❌ | ✅ | | Interactive help system | ❌ | ✅ | | Error suggestions | ❌ | ✅ | | Usage examples in schemas | ❌ | ✅ | | | | | | **Advanced Features** | | | | Prompt composition | ❌ | ✅ | | Usage tracking | ❌ | ✅ | | Template variables | ✅ | ✅ Enhanced | | Recent prompts | ❌ | ✅ | | GitHub status checking | ❌ | ✅ | | | | | | **Developer Experience** | | | | TypeScript | ✅ | ✅ | | Comprehensive tests | ✅ | ✅ Enhanced | | Modular architecture | ✅ | ✅ Enhanced | | Error handling | ✅ | ✅ Enhanced | | CLAUDE.md documentation | ✅ | ✅ Enhanced | ## 🎯 Key Differentiators ### **Original prompts-mcp-server** ✅ **Strengths:** - Simple and focused - Local file management - Clean architecture - Good test coverage - Well-documented 🎯 **Best for:** - Single-user scenarios - Local prompt management - Simple prompt storage needs ### **Enhanced smart-prompts-mcp** ✅ **Strengths:** - GitHub integration for team collaboration - Enhanced AI guidance and workflow - Advanced search capabilities - Prompt composition for complex workflows - Backwards compatible with original 🎯 **Best for:** - Team collaboration - Large prompt libraries - AI assistants that need guidance - Complex prompt workflows - Enterprise scenarios with private repos ## 🤝 Compatibility The enhanced version is **100% backwards compatible**: - All original features work identically - GitHub integration is opt-in - Existing local prompts continue to work - No breaking API changes - Enhanced error messages don't break existing workflows ## 💡 Migration Path Users can migrate from original to enhanced with: 1. **No changes required** - works as drop-in replacement 2. **Optional GitHub setup** - add environment variables to enable 3. **Gradual adoption** - use local files while setting up GitHub 4. **Full compatibility** - can switch back anytime