The Memory Bank MCP Server is a centralized service for remote management of memory bank files across multiple projects. It provides:
Read/Write Operations: Access, create, and update specific files within a project
File Management: List all projects and files within specific projects
Project Isolation: Maintain secure separation between different projects
Consistency: Enforce consistent file naming and structure
Remote Accessibility: Access memory bank files via the MCP protocol
Type-Safe Operations: Ensure proper input validation and error handling
Memory Bank MCP Server
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:
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 Roo Code VS Code extension:
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
For Claude desktop app:
~/Library/Application Support/Claude/claude_desktop_config.json
Add the following configuration to your MCP settings:
Configuration Details
MEMORY_BANK_ROOT
: Directory where project memory banks will be stored (e.g.,/path/to/memory-bank
)disabled
: Set tofalse
to enable the serverautoApprove
: List of operations that don't require explicit user approval:memory_bank_read
: Read memory bank filesmemory_bank_write
: Create new memory bank filesmemory_bank_update
: Update existing memory bank fileslist_projects
: List available projectslist_project_files
: List files within a project
For Cursor
For Cursor, open the settings -> features -> add MCP server -> add the following:
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
Basic development commands:
Running with Docker
Build the Docker image:
docker build -t memory-bank-mcp:local .Run the Docker container for testing:
docker run -i --rm \ -e MEMORY_BANK_ROOT="/mnt/memory_bank" \ -v /path/to/memory-bank:/mnt/memory_bank \ --entrypoint /bin/sh \ memory-bank-mcp:local \ -c "ls -la /mnt/memory_bank"Add MCP configuration, example for Roo Code:
"allpepper-memory-bank": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BANK_ROOT", "-v", "/path/to/memory-bank:/mnt/memory_bank", "memory-bank-mcp:local" ], "env": { "MEMORY_BANK_ROOT": "/mnt/memory_bank" }, "disabled": false, "alwaysAllow": [ "list_projects", "list_project_files", "memory_bank_read", "memory_bank_update", "memory_bank_write" ] }
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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
- Overview
- Features
- Installation
- Quick Start
- Configuration
- For Cursor
- Custom IA instructions
- Development
- Contributing
- License
- Acknowledgments
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.Last updated -16MIT License
- -securityFlicense-qualityA bridge between MCP Host applications and mem0 cloud service, specialized for project management with capabilities to store, retrieve, and search project information within a structured format.Last updated -6
- -securityAlicense-qualityProvides MCP multi-cluster Kubernetes management and operations. It can be integrated as an SDK into your own project and includes nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD resources.Last updated -126MIT License
- AsecurityFlicenseAqualityAn MCP server that helps teams create, manage, and access structured project documentation through six core document types, leveraging AI to generate comprehensive project knowledge management.Last updated -51,750100