memory bank mcp

Local 2025-09-01 00:10:45 0

Provides a centralized MCP-based system for managing and accessing multi-project memory banks remotely, with features like project isolation, file structure validation, and type-safe operations.

A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.

Overview

The Memory Bank MCP Server transforms traditional file-based memory banks into a centralized service that:

Provides remote access to memory bank files via MCP protocol
Enables multi-project memory bank management
Maintains consistent file structure and validation
Ensures proper isolation between project memory banks

Features

Multi-Project Support
Project-specific directories
File structure enforcement
Path traversal prevention
Project listing capabilities
File listing per project
Remote Accessibility
Full MCP protocol implementation
Type-safe operations
Proper error handling
Security through project isolation
Core Operations
Read/write/update memory bank files
List available projects
List files within projects
Project existence validation
Safe read-only operations

Installation

To install Memory Bank Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude

This will set up the MCP server configuration automatically. Alternatively, you can configure the server manually as described in the Configuration section below.

Quick Start

Configure the MCP server in your settings (see Configuration section below)
Start using the memory bank tools in your AI assistant

Configuration

The memory bank MCP server needs to be configured in your Cline MCP settings file. The location depends on your setup:

For Cline extension: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
For Claude desktop app: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following configuration to your MCP settings:

{
  "allpepper-memory-bank": {
    "command": "npx",
    "args": ["-y", "@allpepper/memory-bank-mcp"],
    "env": {
      "MEMORY_BANK_ROOT": "<path-to-bank>"
    },
    "disabled": false,
    "autoApprove": [
      "memory_bank_read",
      "memory_bank_write",
      "memory_bank_update",
      "list_projects",
      "list_project_files"
    ]
  }
}

Configuration Details

MEMORY_BANK_ROOT: Directory where project memory banks will be stored (e.g., /path/to/memory-bank)
disabled: Set to false to enable the server
autoApprove: List of operations that do not require explicit user approval:
memory_bank_read: Read memory bank files
memory_bank_write: Create new memory bank files
memory_bank_update: Update existing memory bank files
list_projects: List available projects
list_project_files: List files within a project

For Cursor

For Cursor, open the settings -> features -> add MCP server -> add the following:

env MEMORY_BANK_ROOT=<path-to-bank> npx -y @allpepper/memory-bank-mcp@latest

Custom IA instructions

This section contains the instructions that should be pasted on the AI custom instructions, either for Cline, Claude or Cursor, or any other MCP client. You should copy and paste these rules. For reference, see custom-instructions.md which contains these rules.

Development

# Install dependencies
npm install

# Build
npm run build

# Test
npm run test

# Watch mode
npm run dev

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Development Guidelines

Use TypeScript for all new code
Maintain type safety across the codebase
Add tests for new features
Update documentation as needed
Follow existing code style and patterns

Testing

Write unit tests for new features
Include multi-project scenario tests
Test error cases thoroughly
Validate type constraints
Mock filesystem operations appropriately

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This project implements the memory bank concept originally documented in the Cline Memory Bank, extending it with remote capabilities and multi-project support.

[
  {
    "description": "Read a memory bank file for a specific project",
    "inputSchema": {
      "properties": {
        "fileName": {
          "enum": [
            "projectbrief.md",
            "productContext.md",
            "activeContext.md",
            "systemPatterns.md",
            "techContext.md",
            "progress.md",
            ".clinerules"
          ],
          "type": "string"
        },
        "projectName": {
          "type": "string"
        }
      },
      "required": [
        "projectName",
        "fileName"
      ],
      "type": "object"
    },
    "name": "memory_bank_read"
  },
  {
    "description": "Create a new memory bank file for a specific project",
    "inputSchema": {
      "properties": {
        "content": {
          "type": "string"
        },
        "fileName": {
          "enum": [
            "projectbrief.md",
            "productContext.md",
            "activeContext.md",
            "systemPatterns.md",
            "techContext.md",
            "progress.md",
            ".clinerules"
          ],
          "type": "string"
        },
        "projectName": {
          "type": "string"
        }
      },
      "required": [
        "projectName",
        "fileName",
        "content"
      ],
      "type": "object"
    },
    "name": "memory_bank_write"
  },
  {
    "description": "Update an existing memory bank file for a specific project",
    "inputSchema": {
      "properties": {
        "content": {
          "type": "string"
        },
        "fileName": {
          "enum": [
            "projectbrief.md",
            "productContext.md",
            "activeContext.md",
            "systemPatterns.md",
            "techContext.md",
            "progress.md",
            ".clinerules"
          ],
          "type": "string"
        },
        "projectName": {
          "type": "string"
        }
      },
      "required": [
        "projectName",
        "fileName",
        "content"
      ],
      "type": "object"
    },
    "name": "memory_bank_update"
  },
  {
    "description": "List all projects in the memory bank",
    "inputSchema": {
      "properties": {},
      "required": [],
      "type": "object"
    },
    "name": "list_projects"
  },
  {
    "description": "List all files within a specific project",
    "inputSchema": {
      "properties": {
        "projectName": {
          "type": "string"
        }
      },
      "required": [
        "projectName"
      ],
      "type": "object"
    },
    "name": "list_project_files"
  }
]