🚀 CastPlan MCP: Your AI Coding Assistant's Missing Memory

🚀 CastPlan MCP: Your AI Coding Assistant's Missing Memory

Turn your AI into a project-aware coding partner - CastPlan MCP gives Claude, Cursor, and other AI assistants the ability to understand, track, and help manage your entire development workflow.

Stop explaining your project to AI every time - CastPlan MCP remembers your architecture, tracks your progress, and helps your AI assistant provide context-aware coding help.

🤔 The Problem: AI That Forgets Your Project

Ever felt frustrated repeating yourself to AI assistants?

You: "Help me add a new user endpoint to my REST API"
AI: "Sure! What's your tech stack? What's your current architecture? 
     Where are your routes defined? What's your authentication system?"
You: "Ugh, I explained this yesterday..." 😤

CastPlan MCP solves this forever.

✨ What CastPlan MCP Actually Does for You

🧠 Your AI Remembers Everything

• Project Architecture: AI knows your file structure, patterns, and conventions
• Development History: Tracks what you've built, changed, and why
• Team Context: Understands your workflow, documentation standards, and processes
• Technical Decisions: Remembers your choices and helps maintain consistency

📈 Real Coding Benefits

🎯 Context-Aware Code Suggestions

Before: "Create a user service"
AI: "Here's a generic user service template..."

After: "Create a user service" 
AI: "Based on your existing AuthService and ProductService patterns, 
     here's a UserService that follows your dependency injection 
     setup and validation middleware..."

📚 Automatic Documentation Updates

You: "I just refactored the payment module"
AI: "I see you moved PaymentProcessor.ts and updated the interfaces. 
     I'll update your README, API docs, and team wiki to reflect 
     the new structure."

🔗 Smart Task Management

You: "We need to add OAuth integration"
AI: "I'll break this down based on your architecture:
     1. Update AuthController (follows your existing auth pattern)
     2. Add OAuth middleware (matches your middleware structure)  
     3. Update user docs (your team wiki format)
     4. Write tests (using your Jest setup)"

🎪 Live Demo: See It In Action

Scenario: Adding a New Feature

🚫 Without CastPlan MCP:

You: "Help me add user profiles"
AI: "What framework are you using?"
You: "React with TypeScript"
AI: "Where do you keep components?"
You: "src/components"
AI: "What's your state management?"
You: "Redux Toolkit"
AI: [Finally gives generic advice]

✅ With CastPlan MCP:

You: "Help me add user profiles"
AI: "I see you're using React + TypeScript with Redux Toolkit. 
     Based on your existing UserCard and ProfileCard components, 
     I'll create a UserProfile component that matches your 
     design system. I'll also update your userSlice following 
     your established patterns and add it to your main navigation."

Scenario: Bug Fixing

🚫 Without CastPlan MCP:

You: "There's a bug in authentication"
AI: "Can you show me your auth code?"
You: [Pastes 200 lines]
AI: "What's the error?"
You: [Explains context]
AI: [Generic debugging advice]

✅ With CastPlan MCP:

You: "There's a bug in authentication"
AI: "I can see your AuthService implementation. Looking at 
     recent changes, I notice the JWT validation was modified 
     2 days ago. The issue is likely in line 45 where the 
     token expiration check changed. Here's the fix that 
     maintains your error handling pattern..."

🛠️ Core Features That Transform Your Coding

📋 Smart Project Planning (BMAD)

What it does: Turns your project ideas into actionable development plans

How it helps your AI:

You: "I want to build a todo app with user auth"
AI: "I've analyzed your requirements and created a development plan:
     
     🏗️ Architecture: React frontend + Node.js API + PostgreSQL
     📝 Tasks Generated:
     1. Setup user authentication system
     2. Create todo CRUD operations  
     3. Build responsive UI components
     4. Add real-time notifications
     
     Each task includes specific acceptance criteria and 
     connects to your existing code patterns."

📚 Living Documentation System

What it does: Keeps your docs in sync with your code automatically

How it helps your AI:

You: "I modified the API endpoints"
AI: "I've detected changes in your routes:
     ✅ Updated API documentation
     ✅ Refreshed README examples  
     ✅ Added new endpoints to Postman collection
     ✅ Updated team wiki with breaking changes
     
     Your documentation is now in sync with code!"

🔗 Workflow Intelligence

What it does: Watches your development patterns and automates repetitive tasks

How it helps your AI:

You: [Commits code with "fix: payment bug"]
AI: "I noticed you fixed a payment issue. Based on your 
     workflow patterns, I've:
     🔄 Generated a hotfix release notes
     📧 Drafted incident report for the team
     🧪 Suggested regression tests to add
     📋 Updated the payment module documentation"

🤖 Code Intelligence & Quality

What it does: AI-powered code analysis that understands your project's context

How it helps your AI:

You: "Review this component for best practices"
AI: "Analyzing against your project standards:
     
     ✅ Follows your component naming convention
     ✅ Uses your established prop patterns
     ⚠️  Missing error boundary (your other components have them)
     ⚠️  Consider adding to your Storybook (matches your docs pattern)
     
     Here's the updated component with your standards applied..."

🚀 Quick Start (30 seconds)

🔥 Instant Setup (Recommended)

# No installation needed - runs directly from GitHub!
uvx --from git+https://github.com/Ghostseller/CastPlan_mcp.git castplan-mcp init

📦 Alternative Installation Methods

# Install with uv
uv add git+https://github.com/Ghostseller/CastPlan_mcp.git
castplan-mcp init

# Install with pip  
pip install git+https://github.com/Ghostseller/CastPlan_mcp.git
castplan-mcp init

# Install with npm
npm install -g git+https://github.com/Ghostseller/CastPlan_mcp.git
castplan-mcp init

Step 3: Start Coding with Context!

Open your AI assistant and try:

"Analyze my project structure and suggest improvements"

That's it! Your AI now understands your project and can provide contextual help.

🎯 Example Developer Scenarios

The following are example scenarios showing how CastPlan MCP could transform different types of development workflows:

👨‍💻 Frontend Developer Scenario

Situation: Working with component libraries and design systems

Example workflow with CastPlan MCP:

Developer: "Create a loading spinner component"
AI: "Based on your existing Button and Modal components, here's a LoadingSpinner 
     that uses your theme tokens, follows your TypeScript patterns, and includes 
     the accessibility features you use in other components."

The benefit: AI understands your specific design system patterns instead of giving generic components.

🔧 Backend Developer Scenario

Situation: Managing microservices with consistent patterns

Example workflow with CastPlan MCP:

Developer: "I need to add a new endpoint to the user service"
AI: "I see your user service uses Express with JWT middleware and follows 
     RESTful patterns. I'll create the endpoint that matches your existing 
     structure, includes your standard error handling, and updates your 
     OpenAPI documentation."

The benefit: AI maintains consistency across your microservices architecture.

🎨 Full-Stack Developer Scenario

Situation: Keeping documentation in sync with code changes

Example workflow with CastPlan MCP:

Developer: [Refactors API response structure]
AI: "I noticed you changed the user object structure. I've updated:
     ✅ Frontend TypeScript interfaces
     ✅ API documentation  
     ✅ Database migration scripts
     ✅ Test fixtures"

The benefit: Automated documentation updates prevent drift between code and docs.

💡 Common Use Cases

🏗️ Starting New Projects

You: "Help me set up a new React TypeScript project with authentication"
AI: "I'll create a project structure following your established patterns:
     - Uses your preferred Vite + TypeScript setup  
     - Includes your standard ESLint/Prettier config
     - Sets up authentication with JWT (matching your other projects)
     - Adds your typical folder structure (components, hooks, utils)
     - Includes your standard testing setup with React Testing Library"

🔧 Debugging & Maintenance

You: "The login isn't working after my recent changes"  
AI: "Looking at your recent commits, I see you updated the AuthContext.
     The issue is in UserContext.tsx line 34 - the token validation
     changed but the error handling wasn't updated. Here's the fix
     that maintains your existing error message patterns."

📈 Scaling & Refactoring

You: "This component is getting too large, help me break it down"
AI: "Based on your existing patterns, I'll split this into:
     - UserProfileHeader (following your header component pattern)
     - UserProfileForm (matches your form validation approach)  
     - UserProfileActions (uses your action button patterns)
     
     Each will use your established props patterns and TypeScript interfaces."

👥 Team Collaboration

You: "A new developer is joining, create onboarding docs"
AI: "I've analyzed your codebase and created onboarding documentation:
     ✅ Architecture overview with your specific patterns
     ✅ Development workflow guide (your Git conventions)
     ✅ Code style guide (extracted from your existing code)
     ✅ Common commands and scripts you actually use
     ✅ Project-specific gotchas and best practices"

🤖 Works With Your Favorite AI Assistants

CastPlan MCP is compatible with any MCP-supported AI environment:

✅ Fully Supported

• Claude Desktop - Native integration, zero configuration
• Cursor - Perfect for VS Code developers
• Windsurf - Advanced coding assistance
• VS Code Extensions - Continue.dev, Cline, and others
• Zed Editor - Lightning-fast development

✅ Future-Proof

• Any MCP-compatible client - Works automatically
• New AI tools - Compatible as they adopt MCP standard

🔧 Setup

castplan-mcp init

This single command detects and configures all your AI assistants automatically.

🛠️ Advanced Configuration

# Enable specific features only
CASTPLAN_ENABLE_DOCS=true        # Documentation tracking
CASTPLAN_ENABLE_PLANNING=true    # Project planning (BMAD)
CASTPLAN_ENABLE_WORKFLOWS=true   # Workflow automation  
CASTPLAN_ENABLE_AI_ANALYSIS=true # AI-powered insights

# Performance tuning
CASTPLAN_WATCH_MODE=true         # Monitor file changes in real-time
CASTPLAN_MAX_CONCURRENT=3        # Number of parallel operations
CASTPLAN_CACHE_ENABLED=true      # Cache project analysis for speed

# Privacy & Security
CASTPLAN_LOCAL_ONLY=true         # Never send data externally
CASTPLAN_AI_PROVIDER=local       # Use local AI models only

🔍 Technical Details

Project Planning:

• bmad_parse_specification - Turn requirements into development tasks
• bmad_update_task_status - Track project progress

Documentation Management:

• docs_reference - Find relevant docs for your work
• docs_update - Keep documentation in sync with code
• docs_search - Search project documentation
• analyze_document_quality - AI-powered doc quality analysis

Workflow Automation:

• hooks_setup_git - Automate Git workflow integration
• hooks_start_watching - Monitor files for changes
• track_document_work - Connect code changes to documentation

System Monitoring:

• castplan://status - Check system health
• castplan://tasks - View active project tasks
• castplan://documentation/history - Track documentation changes

Standard MCP Configuration:

{
  "mcpServers": {
    "castplan-mcp": {
      "command": "castplan-mcp",
      "args": ["start"],
      "env": {
        "CASTPLAN_PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

Configuration Files:

• Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json (Windows)
• Cursor: User settings → MCP servers
• VS Code: Extension-specific configuration

💡 Tip: Use castplan-mcp init instead - it handles all this automatically!

🙋‍♂️ FAQ

GitHub Copilot suggests code based on general patterns.

CastPlan MCP gives your AI assistant memory of YOUR specific project:

• Knows your existing code patterns and conventions
• Tracks your project's evolution over time
• Understands relationships between your files
• Maintains context about your team's decisions

Think of Copilot as "smart autocomplete" and CastPlan MCP as "project memory for AI."

No! CastPlan MCP runs locally on your machine. Your code never leaves your computer unless you explicitly configure it to use external AI services (which is optional).

By default, it only provides context to your local AI assistant.

No! CastPlan MCP is designed for speed:

• Intelligent caching keeps responses fast
• Only loads relevant context for each query
• Runs in the background without interrupting your workflow
• Most operations complete in milliseconds

CastPlan MCP automatically detects which project you're working on and provides the right context. Each project maintains its own separate memory and configuration.

🚀 Ready to Transform Your AI Coding Experience?

# Install CastPlan MCP in 30 seconds
npm install -g @castplan/automation-mcp
castplan-mcp init

# Start getting contextual AI help immediately  

📞 Support & Community

• 🐛 Found a bug? Report it here
• 💬 Questions? Join the discussion
• 📧 Need help? [email protected]