Claude Context Plus 🚀

An intelligent MCP (Model Context Protocol) server that enhances Claude Code's understanding of your projects through comprehensive analysis and AI-powered insights.

✨ Features

📊 Comprehensive Project Analysis

• Multi-platform support: Android, iOS, Flutter, and web projects
• Deep architecture analysis: Detects patterns, frameworks, and design decisions
• Code style analysis: Understands your coding conventions and preferences
• Dependency mapping: Analyzes and categorizes all project dependencies

🧠 AI-Powered Intelligence (NEW!)

• Background Analysis: Real-time monitoring and learning from your development patterns
• Predictive Insights: AI suggestions based on your workflow and project context
• Smart Recommendations: Context-aware suggestions for improvements and optimizations
• User Behavior Learning: Adapts to your coding style and preferences over time

🔍 Platform-Specific Analysis

Android Projects

• Gradle configuration analysis
• AndroidManifest.xml parsing
• Activity/Fragment detection
• Jetpack Compose usage analysis
• Architecture pattern recognition (MVC, MVP, MVVM, Clean Architecture)

iOS Projects

• Xcode project structure analysis
• Info.plist configuration parsing
• UIKit vs SwiftUI detection
• CocoaPods and Swift Package Manager support
• Architecture pattern detection (MVC, MVP, MVVM, VIPER)

Flutter Projects

• Pubspec.yaml analysis
• Widget structure mapping
• State management detection (BLoC, Provider, Riverpod, GetX)
• Multi-platform support analysis
• Asset and localization tracking

🛠 Installation

npm install claude-context-plus

🚀 Quick Start

1. Configure MCP in Claude Code

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "claude-context-plus": {
      "command": "node",
      "args": ["path/to/claude-context-plus/dist/index.js"],
      "env": {
        "ENABLE_BACKGROUND_ANALYSIS": "true",
        "ENABLE_FILE_WATCHING": "true",
        "ENABLE_PREDICTIVE_ANALYSIS": "true"
      }
    }
  }
}

2. Set Current Project (Recommended) ⭐

NEW! Set your current working directory as the default project path for all operations:

# Set current directory as the project path
set_current_project

# Or specify a custom path
set_current_project {"project_path": "/path/to/your/project"}

# Check current project settings
get_current_project

3. Basic Project Analysis

Once you've set the current project, all commands become much simpler:

# Analyze your project structure (no path needed!)
analyze_project

# Get intelligent context with AI insights (NEW: Simple string format!)
get_intelligent_context "Help me understand this codebase"

# Or use detailed object format for more control
get_intelligent_context {"user_query": "Help me understand this codebase", "user_intent": "debugging"}

# Traditional approach with explicit paths still works
analyze_project {"project_path": "/path/to/your/project", "focus_areas": ["all"]}

4. Enable Smart Features

# Start background analysis for real-time learning
start_background_analysis

# Get AI-powered suggestions (NEW: Simple string format!)
get_smart_suggestions "improving code quality"

# Or use detailed object format
get_smart_suggestions {"context": "performance optimization", "project_path": "/custom/path"}

🧠 Intelligent Features

Background Analysis

The system continuously monitors your development patterns and learns from your interactions:

• File Change Monitoring: Tracks which files you modify most frequently
• Workflow Pattern Recognition: Identifies whether you're debugging, developing features, or refactoring
• Efficiency Analysis: Measures and suggests improvements to your development workflow

Predictive Insights

AI-powered predictions based on your current context:

• Next Action Suggestions: Predicts what you're likely to do next
• Related File Recommendations: Suggests files you might need to examine
• Query Suggestions: Recommends search terms based on your current task

Smart Suggestions

Context-aware recommendations for:

• Code Quality: Suggests improvements based on detected patterns
• Testing Strategy: Recommends test approaches for your current work
• Architecture Improvements: Identifies refactoring opportunities
• Documentation Enhancements: Suggests areas needing better documentation

⚙️ Configuration

Environment Variables

# Basic Configuration
EXCLUDE_PATTERNS="node_modules/**,dist/**,build/**"
MAX_FILE_SIZE="1024"                    # KB
ANALYSIS_DEPTH="medium"                 # light|medium|deep
CACHE_DURATION="30"                     # minutes

# Intelligence Features
ENABLE_BACKGROUND_ANALYSIS="true"       # Enable AI learning
ENABLE_FILE_WATCHING="true"             # Monitor file changes
ENABLE_INTERACTION_TRACKING="true"      # Track user interactions
ENABLE_PREDICTIVE_ANALYSIS="true"       # Enable AI predictions

MCP Tools Available

| Tool | Description | Use Case | |------|-------------|----------| | analyze_project | Basic project analysis | Initial project understanding | | get_project_context | Structured context for Claude | Getting project overview | | get_intelligent_context | AI-enhanced context with insights | Deep project understanding | | start_background_analysis | Enable real-time learning | Ongoing intelligence gathering | | get_smart_suggestions | AI-powered recommendations | Workflow optimization | | find_related_files | Find files related to a task | Targeted development | | update_context_cache | Refresh analysis cache | Keep analysis current |

🎯 Use Cases

For New Projects

1. Quick Understanding: get_intelligent_context provides instant project insights
2. Architecture Review: Understand patterns and design decisions
3. Dependency Analysis: See what libraries and frameworks are used

For Active Development

1. Smart Suggestions: Get AI recommendations while coding
2. Pattern Learning: System learns your preferences and suggests optimizations
3. Predictive Help: Anticipates your next actions and prepares relevant context

For Code Reviews

1. Comprehensive Analysis: Deep dive into code quality and architecture
2. Issue Detection: Identify potential problems and improvements
3. Best Practice Suggestions: Get recommendations based on project patterns

🚀 What Makes It Intelligent?

Unlike traditional static analysis tools, Claude Context Plus:

• Learns from Usage: Adapts to your coding patterns and preferences
• Contextual Awareness: Understands what you're trying to accomplish
• Predictive Capabilities: Anticipates your needs and prepares relevant information
• Multi-Modal Analysis: Combines structural, behavioral, and contextual analysis
• Real-Time Adaptation: Continuously improves its understanding of your project

🎯 Enhanced User Experience

Dual Input Format Support

Most commands now support both simple string and detailed object formats:

Simple Format (Quick & Easy):

get_intelligent_context "Help me understand this Flutter app"
get_smart_suggestions "performance optimization"
find_related_files "user authentication"

Detailed Format (Full Control):

get_intelligent_context {"user_query": "Help me", "user_intent": "debugging", "project_path": "/custom/path"}
get_smart_suggestions {"context": "performance", "project_path": "/path"}
find_related_files {"task_description": "auth", "file_types": [".dart"], "max_results": 5}

This makes the tools more accessible for quick queries while maintaining full flexibility for advanced use cases.

🔮 Future Roadmap

• Team Learning: Share insights across team members
• Integration Patterns: Deep integration with popular development tools
• Custom Rules: Define project-specific analysis rules
• Performance Monitoring: Track and optimize development velocity
• AI Code Generation: Generate code based on learned patterns

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built with love for the developer community. Special thanks to:

• Anthropic for Claude and the MCP protocol
• The open-source community for amazing tools and libraries
• All developers who make software development a joy

Made with ❤️ for Claude Code users who want their AI assistant to truly understand their projects.