🛡️ MCP Guardian - Stop AI From Writing Duplicate Code

The Problem

AI coding assistants immediately start writing code without checking what already exists. Result? Duplicate functions, broken APIs, and hours of debugging.

The Solution

Guardian enforces a 3-gate engineering workflow:

1. Analysis Gate - AI must search and analyze existing code first
2. Planning Gate - AI submits a plan for your approval
3. Execution Gate - Step-by-step implementation with progress tracking

Key Features

🚫 Prevents Code Duplication

• Forces AI to find existing implementations before creating new ones
• Maps function relationships and dependencies
• Maintains persistent memory of your codebase structure

🔒 API Contract Locking

• Store working API endpoints that can't be broken
• Protects external integrations during refactoring
• Ensures backward compatibility

⚡ Rust-Powered Performance

• AST parsing handles 10,000+ files in milliseconds
• Tree-sitter based code analysis
• Local SQLite database for instant searches

💾 Persistent Project Memory

• Remembers your codebase structure across sessions
• Stores ground truth about configs and architecture
• Builds institutional memory for your AI assistant

📊 Usage Transparency

• Track every tool invocation
• Monitor AI's analysis patterns
• Full request logging and analytics

Perfect For

• Starting new features - Ensures code reuse
• Refactoring legacy code - Prevents breaking changes
• API development - Locks endpoint contracts
• Team projects - Maintains consistency

How It Works

# 1. Install via npm
npm install -g @skyastrall/mcp-guardian

# 2. Add to your MCP config
{
  "mcpServers": {
    "guardian": {
      "command": "npx",
      "args": ["-y", "@skyastrall/mcp-guardian"],
      "env": {
        "GUARDIAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

# 3. Tell AI to use Guardian gates
"Use Guardian gates to implement [feature]"

Example Workflow

You: "Use Guardian gates to add user authentication"

AI: [ANALYSIS GATE] Searching codebase...
    ✓ Found: handleLogin (auth.rs:42)
    ✓ Found: authenticateUser (middleware.rs:18)
    
    [PLANNING GATE] Auth system already exists!
    Plan: Extend existing auth instead of creating new
    
    Approve plan? [Y/n]

You: Y

AI: [EXECUTION GATE] Implementing step by step...
    ✓ Step 1: Extended existing handleLogin
    ✓ Step 2: Added OAuth support to authenticateUser
    ✓ Complete: No duplicate code created

Pricing

• Free (Meteor): 200 requests/month
• Pro (Comet): $9/mo - 500 requests/month
• Unlimited (Supernova): $25/mo - Unlimited requests

Why Guardian?

• Save 4+ hours per feature - No duplicate debugging
• 87% fewer bugs - Preventive vs reactive development
• Peace of mind - AI can't break existing code
• Learn once, use forever - Persistent memory

Links

• 📦 NPM Package
• 🌐 Dashboard
• 📖 Documentation
• 💬 Support

Built with Rust for blazing performance. Trusted by developers who value clean, maintainable code.