Memory Bank MCP

A guided Memory Bank plugin for AI-assisted development

Memory Bank MCP is a Model Context Protocol (MCP) plugin that helps AI assistants maintain persistent project context through structured markdown files. It provides a systematic approach to tracking project goals, decisions, progress, and patterns through guided instructions rather than direct operations.

Features

• Guided Operations: Provides instructions for AI assistants to perform operations themselves

• Structured Context Management: Organize project information across 5 core files

• Intelligent Guidance: Step-by-step instructions for initialization and updates

• Flexible Updates: Smart update guidance based on different change types

• Cross-Platform Support: Automatic path normalization for Windows/macOS/Linux

MCP Configuration

Using the published npm package:

Quick Start

1. Initialize Memory Bank

   Use init-memory-bank to create the memory-bank directory and core files

2. Read Memory Bank

   Use get-memory-bank-info to view all Memory Bank content

3. Update Memory Bank

   Use update-memory-bank to get guidance on updating specific files

Core Files

1. productContext.md (Product Context)

• High-level project overview

• Goals and key features

• Overall architecture

• Automatically incorporates projectBrief.md if available

2. activeContext.md (Active Context)

• Current work status

• Recent changes

• Open questions and issues

• Focus areas

3. progress.md (Progress)

• Task tracking in checklist format

• Completed, current, and planned tasks

• Progress timeline

4. decisionLog.md (Decision Log)

• Architectural and implementation decisions

• Rationale and implications

• Decision history

5. systemPatterns.md (System Patterns)

• Recurring patterns and standards

• Coding conventions

• Architectural patterns

• Testing strategies

Usage Guidelines

For AI Assistants

1. Start Every Session: Check if memory-bank directory exists, then use get-memory-bank-info to understand project state

2. Initialize When Needed: Use init-memory-bank for new projects

3. Read Context: Use get-memory-bank-info to understand project state

4. Update Guidance: Use update-memory-bank to get update instructions

5. Follow Instructions: Execute the provided guidance to maintain Memory Bank

Update Triggers

• Architecture Changes: Major structural decisions

• Feature Completion: New features or capabilities

• Bug Fixes: Significant issue resolutions

• Refactoring: Code structure improvements

• Decisions: Any important technical choices

• Progress Updates: Task status changes

Tool Reference

init-memory-bank

Initializes Memory Bank with all core files.

Parameters:

• rootPath: Project root directory path

• force (optional): Force re-initialization

Returns: Created files list and next steps guidance

get-memory-bank-info

Reads and returns all Memory Bank content (similar to codelf's get-project-info).

Parameters:

• rootPath: Project root directory path

Returns: Formatted Memory Bank content for AI context

update-memory-bank

Provides guidance for updating Memory Bank files.

Parameters:

• rootPath: Project root directory path

• changeType: Type of change (architecture/feature/bugfix/refactor/decision/progress)

• description: Brief description of the change

Returns: Detailed update instructions with templates and timestamps

Integration Tips

Cursor Setup

Add to Settings → Rules → User Rules:

Windsurf Setup

Add to Settings → Cascade → Memories and Rules → Global Rules:

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT

Acknowledgments

Inspired by the SPARC methodology and codelf.