Skip to main content
Glama

CastPlan MCP

by Ghostseller

🚀 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)

# 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


⭐ Give CastPlan MCP a star if it makes your coding life easier!

🧠 Stop explaining your project to AI every time

🚀 Install Now💬 Discuss📧 Contact

Built with ❤️ for developers who want smarter AI assistance

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides AI assistants with persistent memory of your project architecture, development history, and technical decisions, allowing them to give context-aware coding help without needing repeated explanations.

  1. 🤔 The Problem: AI That Forgets Your Project
    1. ✨ What CastPlan MCP Actually Does for You
      1. 🧠 Your AI Remembers Everything
      2. 📈 Real Coding Benefits
    2. 🎪 Live Demo: See It In Action
      1. Scenario: Adding a New Feature
      2. Scenario: Bug Fixing
    3. 🛠️ Core Features That Transform Your Coding
      1. 📋 Smart Project Planning (BMAD)
      2. 📚 Living Documentation System
      3. 🔗 Workflow Intelligence
      4. 🤖 Code Intelligence & Quality
    4. 🚀 Quick Start (30 seconds)
      1. 🔥 Instant Setup (Recommended)
      2. 📦 Alternative Installation Methods
      3. Step 3: Start Coding with Context!
    5. 🎯 Example Developer Scenarios
      1. 👨‍💻 Frontend Developer Scenario
      2. 🔧 Backend Developer Scenario
      3. 🎨 Full-Stack Developer Scenario
    6. 💡 Common Use Cases
      1. 🏗️ Starting New Projects
      2. 🔧 Debugging & Maintenance
      3. 📈 Scaling & Refactoring
      4. 👥 Team Collaboration
    7. 🤖 Works With Your Favorite AI Assistants
      1. ✅ Fully Supported
      2. ✅ Future-Proof
      3. 🔧 Setup
    8. 🛠️ Advanced Configuration
      1. 🔍 Technical Details
        1. 🙋‍♂️ FAQ
          1. 🚀 Ready to Transform Your AI Coding Experience?
            1. 📞 Support & Community
              1. ⭐ Give CastPlan MCP a star if it makes your coding life easier!

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices.
              Last updated -
              4
              65
              73
              TypeScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              Provides a structured documentation system for context preservation in AI assistant environments, helping users create and manage memory banks for their projects.
              Last updated -
              3
              66
              Python
              MIT License
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              Enables AI assistants to maintain persistent project context across sessions by storing and retrieving structured information in markdown files organized in a memory bank directory.
              Last updated -
              4
              53
              JavaScript
              Apache 2.0
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              Provides AI assistants with enhanced reasoning capabilities through structured thinking, persistent knowledge graph memory, and intelligent tool orchestration for complex problem-solving.
              Last updated -
              20
              412
              27
              TypeScript
              MIT License
              • Apple
              • Linux

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ghostseller/CastPlan_mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server