Fork Notice: This is a fork of the original memory-bank-mcp by Aliosh Pimenta, enhanced with MongoDB-native features and real-time statistics tracking.
A modern Model Context Protocol (MCP) server implementation for MongoDB-powered memory bank management.
- 🗄️ MongoDB-powered storage with advanced indexing and search capabilities
- 🏢 Multi-project isolation with automatic project management
- 📊 Real-time statistics tracking for all projects and files
- 🔒 Type-safe operations with Zod validation and error handling
- 🔀 Smart merge functionality with automatic cleanup
- 🚀 Optimized MCP protocol implementation
- MongoDB Server running locally or remotely (MongoDB 4.4+ recommended)
- Node.js 18+ for running the MCP server
- An MCP-compatible client (Claude Desktop, Cline, Cursor, etc.)
npm install -g memory-bank-mcp-mongodbgit clone https://github.com/Sato-Isolated/memory-mongo-bank-mcp.git
cd memory-mongo-bank-mcp
pnpm install
pnpm run build-
Start MongoDB:
# Windows (if installed as service) net start MongoDB # macOS/Linux mongod # Or use Docker docker run -d -p 27017:27017 mongo:latest
-
Configure your MCP client (see Configuration section below)
MONGODB_URL(required): MongoDB connection string (e.g.,mongodb://localhost:27017)MONGODB_DB(optional): MongoDB database name (defaults tomemory_bank)
VS Code with MCP Extension:
{
"mcp": {
"servers": {
"memory-bank-mongo": {
"command": "npx",
"args": ["-y", "memory-bank-mcp-mongodb"],
"env": {
"MONGODB_URL": "mongodb://localhost:27017",
"MONGODB_DB": "memory_bank"
}
}
}
}
}Claude Desktop, Cline, Cursor:
{
"memory-bank": {
"command": "npx",
"args": ["-y", "memory-bank-mcp-mongodb"],
"env": {
"MONGODB_URL": "mongodb://localhost:27017",
"MONGODB_DB": "memory_bank"
}
}
}Cursor (Alternative):
env MONGODB_URL=mongodb://localhost:27017 MONGODB_DB=memory_bank npx -y memory-bank-mcp-mongodbThis project uses distributed documentation to help you navigate different sections:
- Source Code Overview - Architecture patterns and project structure
- Domain Layer - Business entities and core logic
- Data Layer - Repository patterns and use cases
- Presentation Layer - Controllers and API endpoints
- Infrastructure - Database and external services
[PRIORITY 1 - START HERE] List all projects in the memory bank. ALWAYS use this first to discover available projects before any other operation. Essential for understanding workspace structure.
[PRIORITY 2 - EXPLORE] List all files within a specific project. Use after list_projects to discover what files exist before reading them. Critical for understanding project content.
[PRIORITY 3 - READ] Read a memory bank file for a specific project. Primary method to access file content. Use after list_project_files to read specific files.
[HIGH PRIORITY - SEARCH] Search for files containing specific text within a project. Essential for finding relevant files when you don't know exact filenames.
[CREATE NEW] Create a new memory bank file for a specific project. Use when you need to create brand new files.
[MODIFY EXISTING] Update an existing memory bank file for a specific project. Automatically creates version history.
[COMPREHENSIVE VIEW] Merge all files from a project into a single formatted document. Excellent for understanding full project context.
[SMART FILTER] Find files in a project by their tags. Helpful when you know the type of content you're looking for but not exact filenames.
[PROJECT OVERVIEW] Get statistics for a project including file count and total size. Use to understand project scope and scale.
[CAREFUL - DELETE FILE] Delete a specific file from a project.
[DANGER - DELETE PROJECT] Delete an entire project and all its files.
[VERSION HISTORY] Get complete version history for a specific file. Shows all previous versions with metadata and timestamps.
[READ SPECIFIC VERSION] Read the content of a specific file version. Use to view historical content of a particular version.
[RESTORE PREVIOUS VERSION] Restore a file to a previous version. Creates a new version with the old content for safety.
[COMPARE VERSIONS] Compare two versions of a file to see differences. Use to understand what changed between versions.
[MAINTENANCE] Clean up old file versions to save storage space. Keeps recent versions and removes older ones.
[TEMPLATE DISCOVERY] List available project templates. Essential when starting new projects from predefined structures.
[RAPID PROJECT CREATION] Create a new project using a template. Fastest way to start structured projects.
[FIRST-TIME SETUP] Install built-in project templates. Run this ONCE when first using the system to add default templates.
Local MongoDB:
MONGODB_URL=mongodb://localhost:27017
MONGODB_DB=memory_bankMongoDB Atlas (Cloud):
MONGODB_URL=mongodb+srv://username:password@cluster.mongodb.net
MONGODB_DB=memory_bank"Failed to connect to MongoDB"
- Ensure MongoDB is running on the specified port
- Check network connectivity and firewall settings
- Verify connection string format and credentials
"MONGODB_URL environment variable is required"
- Set the required environment variables in your MCP client configuration
- Verify the environment variables are properly formatted
Tools not appearing in AI client
- Restart your AI client after configuration changes
- Check that the package is properly installed
- Review client logs for connection errors
MIT License - see the LICENSE file for details.
- NPM Package: https://www.npmjs.com/package/memory-bank-mcp-mongodb
- GitHub Repository: https://github.com/Sato-Isolated/memory-mongo-bank-mcp
- Original Project: https://github.com/alioshr/memory-bank-mcp
A modern, MongoDB-powered memory bank solution for AI assistants and development workflows.