DukeDeSouth/m7-mcp

M7 MCP Server 🚀

Enterprise-grade Model Context Protocol (MCP) server implementing the M7 IDEAL methodology for systematic, error-free development.

🎯 What is M7 MCP?

M7 MCP is a powerful development assistant that enforces best practices, prevents common mistakes, and guides you through a structured development process. It acts as your intelligent pair programmer, ensuring quality and consistency across your entire project.

Key Features

• 🧠 Intelligent Memory System - Remembers patterns, decisions, and project context
• 🛡️ Anti-Chaos Protection - Prevents scope creep and chaotic development
• 📋 PROJECT_SCHEMA.yaml - Single source of truth for your project structure
• 🔍 Smart Error Prevention - Learns from mistakes and prevents repetition
• 📊 Enterprise Dashboard - Real-time insights and metrics
• 🎯 Task Orchestration - Guides through Discovery → Architecture → Implementation

🚀 Quick Start

Installation

1. Install in Cursor IDE by adding to ~/.cursor/mcp.json:

{
  "m7": {
    "command": "npx",
    "args": ["-y", "@m7/mcp-server"]
  }
}

2. Restart Cursor

3. Start using M7 commands:

# Initialize a new project
@m7 init_project "My Awesome App"

# Analyze any task
@m7 analyze_task "Build user authentication"

# Check project schema
@m7 schema view

# Get development insights
@m7 enterprise_dashboard

📚 Core Concepts

The M7 Methodology

M7 follows the IDEAL approach:

1. Identify - Understand the problem deeply
2. Discover - Research and explore solutions
3. Engineer - Design robust architecture
4. Accelerate - Implement efficiently
5. Learn - Capture patterns and improve

PROJECT_SCHEMA.yaml

Never create duplicate databases again! M7 maintains a single source of truth:

project:
  name: "My App"
  version: "1.0.0"
  
database:
  primary:
    type: "PostgreSQL"
    name: "production_db"
    
api:
  endpoints:
    auth:
      - "POST /login"
      - "POST /register"

Smart Tools

M7 provides 11 intelligent tools:

• analyze_task - Deep task analysis with risk assessment
• schema - Manage project structure
• memory - Search and store patterns
• session - Track development sessions
• validate - Run quality checks
• scope - Prevent scope creep
• navigate - Track your position in complex tasks
• init_project - Bootstrap new projects
• check_errors - Learn from past mistakes
• create_structure - Generate M7 file structure
• enterprise_dashboard - View insights and metrics

🔧 Advanced Features

Memory Levels

M7 uses a 5-level memory system:

1. Surface - Current task context
2. Working - Active session data
3. Long-term - Established patterns
4. Conceptual - Core principles
5. Project - Project-wide knowledge

Intelligent Hints

Get context-aware suggestions:

• Architecture recommendations
• Performance optimizations
• Security considerations
• Best practice reminders

Error Prevention

M7 actively prevents:

• Creating duplicate databases
• Using unverified libraries
• Repeating past mistakes
• Scope creep
• Inconsistent patterns

📖 Example Workflow

# 1. Initialize project
@m7 init_project "E-commerce Platform"

# 2. Analyze your first feature
@m7 analyze_task "Build product catalog with search"

# 3. Check what M7 discovered
@m7 memory search "catalog architecture"

# 4. Implement with guidance
@m7 navigate push "Implement search algorithm"

# 5. Validate your work
@m7 validate baseline_audit

# 6. View your progress
@m7 enterprise_dashboard

🤝 Contributing

We welcome contributions! Please see our for details.

📄 License

MIT License - see for details.

🙏 Acknowledgments

Built with:

• Model Context Protocol SDK
• TypeScript
• Love for clean, systematic development

Remember: "Architecture first, implementation second. Discovery prevents chaos." 🎯