Memory-Bank-MCP by lgpearson1771 - MCP Server

Memory Bank Generator MCP Server

🧠 Professional Memory Bank Generation for AI-Assisted Development

Comprehensive project documentation that helps AI assistants understand your codebase

Enterprise-ready MCP server with intelligent project analysis

A production-ready MCP server that automatically generates comprehensive memory banks with the use of your AI assistant. Analyze any project and create structured documentation that dramatically improves AI understanding and assistance quality.

🎯 What It Does

Deep Project Analysis: Advanced scanning of files, dependencies, patterns, and architecture
Intelligent Content Generation: Creates 6 core memory bank files with project-specific content
AI Integration Setup: Automatically configures GitHub Copilot and other AI assistants
Quality Validation: Ensures professional documentation with comprehensive validation
Performance Optimized: Handles projects of any size efficiently (tested up to 500+ files)

🚀 Quick Start

🚀 One-Click Install (Recommended)

For VS Code users, click one of these buttons to automatically configure the MCP server:

📝 Note: These buttons automatically add the npm package configuration to your mcp.json file. If the links don't open VS Code, try right-clicking and selecting "Open link" or use manual setup below.

Installation Options

🌟 Option 1: npm package (Recommended - No local setup required)

The easiest way to use Memory Bank MCP is via npm. The one-click install buttons above will automatically configure this for you, or you can add it manually to your MCP configuration:

VS Code MCP Extension:

{
  "servers": {
    "MemGen MCP": {
      "command": "npx",
      "args": ["@lgpearson1771/memory-bank-mcp@latest"],
      "type": "stdio"
    }
  }
}

Claude Desktop:

{
  "mcpServers": {
    "MemGen MCP": {
      "command": "npx",
      "args": ["@lgpearson1771/memory-bank-mcp@latest"]
    }
  }
}

🛠️ Option 2: Local Development Setup

For development or customization:

git clone https://github.com/lgpearson1771/Memory-Bank-MCP.git
cd Memory-Bank-MCP
npm install
npm run build

Setup for VS Code

Manual Configuration:

Option A: npm package (recommended)

{
  "servers": {
    "MemGen MCP": {
      "command": "npx",
      "args": ["@lgpearson1771/memory-bank-mcp@latest"],
      "type": "stdio"
    }
  }
}

Option B: Local installation

{
  "servers": {
    "MemGen MCP": {
      "command": "node",
      "args": ["<MCP_SERVER_PATH>\\dist\\index.js"],
      "env": {
        "LOG_LEVEL": "info"
      },
      "type": "stdio"
    }
  }
}

For Claude Desktop

Find Claude Desktop's configuration file:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add your MCP server configuration:

Option A: npm package (recommended)

{
  "mcpServers": {
    "MemGen MCP": {
      "command": "npx",
      "args": ["@lgpearson1771/memory-bank-mcp@latest"]
    }
  }
}

Option B: Local installation

{
  "mcpServers": {
    "MemGen MCP": {
      "command": "node",
      "args": ["<MCP_SERVER_PATH>\\dist\\index.js"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Restart Claude Desktop - Your 6 MCP tools will be available!

Verify Installation

Run Unit Tests:

node tests/unit/validate-tools.js

Run Integration Tests:

node tests/integration/run-all.mjs

Quick Tool Test:

node tests/integration/quick-test.js

You should see: ✅ All tests passed! MCP tools are working correctly.

Documentation

📁 - All guides, setup instructions, and technical details

Quick Links:

- Installation for Claude Desktop and VS Code
- Ready-to-use config files
- Technical documentation and testing strategy

##�🛠️ Available Tools

5 MCP Tools for Memory Bank Management:

generate_memory_bank - Creates comprehensive memory banks with full project analysis
analyze_project_structure - Deep analysis of project structure, dependencies, and patterns
update_memory_bank - Updates existing memory banks with current project state
validate_memory_bank - Validates memory bank completeness and AI integration
setup_copilot_instructions - Configures AI assistants to use your memory bank

📁 What Gets Created

Memory banks are created in .github/memory-bank/ with these files:

.github/
├── memory-bank/
│   ├── projectbrief.md          # Project overview
│   ├── productContext.md        # Goals and purpose  
│   ├── activeContext.md         # Current work
│   ├── systemPatterns.md        # Architecture
│   ├── techContext.md           # Tech stack
│   └── progress.md              # Status
└── copilot-instructions.md      # Copilot config

Optional: You can request additional files organized in semantic folders like features/, api/, deployment/, etc.

🎯 How It Works

Intelligent Analysis & Generation

Professional Workflow

You: "Generate a memory bank for my project at C:\MyProject"
MCP: Deep Analysis → Content Generation → Memory Bank Creation → AI Integration

Advanced Processing

Project Intelligence: Analyzes dependencies, architecture, patterns, and business context
Professional Content: Generates enterprise-grade documentation with project-specific details
Smart Organization: Creates structured memory banks with comprehensive file organization
Automatic Integration: Sets up AI assistants with proper memory bank references
Quality Assurance: Validates content quality and completeness

Result: 6 professional memory bank files with detailed project analysis, not generic templates.

💡 Why Use This?

Enterprise Quality: Professional documentation suitable for production environments
Deep Understanding: AI assistants gain comprehensive knowledge of your project
Zero Manual Work: Fully automated generation and AI integration
Performance Tested: Handles large projects efficiently (500+ files in <1 second)
Production Ready: Comprehensive test coverage with 23 integration tests
Universal Compatibility: Works with Claude Desktop, VS Code, and all MCP-compatible tools

🤝 Contributing

This project started at the 2025 Microsoft Hackathon and is now production-ready!

git clone https://github.com/lgpearson1771/Memory-Bank-MCP.git
cd Memory-Bank-MCP
npm install
npm run dev

� More Info

Made with ❤️ for developers who want smarter AI assistants