Memory Bank

Memory Bank MCP Server lets AI assistants store and retrieve memory across sessions by managing Memory Banks locally or on a remote server via SSH. It provides tools to initialize banks, track progress, log decisions, and switch operational modes to optimize interactions with your project context.

How to use

You can run Memory Bank MCP directly from your terminal to interact with Memory Banks during AI conversations. Use the memory bank to initialize a bank, read and write context files, track progress, and log important decisions. You can also run Memory Bank MCP in a remote server mode to centralize and share memory across teammates.

Practical usage patterns you can adopt include initializing a memory bank at a project path, updating progress as tasks evolve, logging critical decisions with context and alternatives, and switching between modes such as code, architect, ask, debug, and test to tailor the assistant’s behavior.

How to install

Prerequisites: you need a working Node.js environment and npm or npx available on your system.

Install using npm or run without installation with npx.

# Install from npm (local install)
npm install @aakarsh-sasi/memory-bank-mcp

# Or install globally
npm install -g @aakarsh-sasi/memory-bank-mcp

# Or run directly with npx (no installation required)
npx @aakarsh-sasi/memory-bank-mcp

Additional configuration and usage notes

Remote Server Mode enables storing your Memory Bank on a remote server via SSH. This requires SSH access to the remote host and SSH key authentication.

To run remotely, you provide SSH connection details and the remote path where the Memory Bank is stored.

npx @aakarsh-sasi/memory-bank-mcp --remote \
  --ssh-key ~/.ssh/your_ssh_key \
  --remote-user username \
  --remote-host example.host.com \
  --remote-path /home/username/memory-bank

Tools you can use with Memory Bank MCP

The server provides a set of tools to manage the Memory Bank and its contents. You can initialize the bank, track progress, log decisions, and switch modes during a session.

Available tools

initialize_memory_bank

Create and set up a new Memory Bank at a specified path so you can start storing project context.

track_progress

Record progress updates with a descriptive action and details to maintain a history of changes.

log_decision

Capture important decisions with context and rationale to reference later.

switch_mode

Change the operational mode (code, architect, ask, debug, test) to tailor how the assistant works with the Memory Bank.