JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 87
  • Score
    100M100P100Q84526F
  • License MIT

MongoDB-powered Memory Bank MCP server with hybrid search capabilities for AI assistants

Package Exports

  • mongodb-memory-bank-mcp
  • mongodb-memory-bank-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mongodb-memory-bank-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Memory Bank MCP Server

npm version License: MIT

A MongoDB-powered Memory Bank MCP (Model Context Protocol) server that creates an intelligent, project-aware memory system for AI assistants. Built with MongoDB Atlas Vector Search's hybrid search capabilities.

What It Does

This MCP server provides AI assistants with persistent memory across sessions by:

  • Storing structured project documentation in MongoDB
  • Using vector embeddings for semantic search
  • Combining vector and text search for powerful hybrid queries
  • Maintaining strict project isolation
  • Providing tools for reading, updating, and searching memories

Features

  • 🧠 Intelligent Memory System - Structured documentation that evolves with your project
  • 🔍 Hybrid Search - Combines MongoDB's vector and text search capabilities
  • 🏗️ Project Isolation - Each project maintains its own memory space
  • 🚀 High-Performance - Leverages MongoDB indexes and Voyage AI embeddings
  • 🔧 MCP Integration - Works seamlessly with Claude and other MCP-compatible AI assistants

Installation

Prerequisites

  • Node.js 18+
  • MongoDB Atlas cluster with Vector Search enabled
  • Voyage AI API key

Run directly with npx (no installation needed):

# Set environment variables
export MONGODB_URI="your-mongodb-uri"
export VOYAGE_API_KEY="your-voyage-key"

# Run the server
npx mongodb-memory-bank-mcp

Or configure in Claude's MCP settings:

{
  "mcpServers": {
    "memory-bank": {
      "command": "npx",
      "args": ["mongodb-memory-bank-mcp"],
      "env": {
        "MONGODB_URI": "your-mongodb-uri",
        "VOYAGE_API_KEY": "your-voyage-key"
      }
    }
  }
}

Local Development

  1. Clone the repository:
git clone https://github.com/romiluz13/mongodb-memory-bank-mcp.git
cd mongodb-memory-bank-mcp
  1. Install dependencies:
pnpm install
  1. Configure environment:
cp .env.example .env.local
# Edit .env.local with your MongoDB URI and Voyage AI key
  1. Build the project:
pnpm build
  1. Create MongoDB indexes:
pnpm db:indexes

Running Locally

Development Mode

pnpm dev

Testing with MCP Inspector

pnpm mcp:inspect

Running Tests

pnpm test

Usage with Claude

Add to your Claude MCP settings:

{
  "mcpServers": {
    "memory-bank": {
      "command": "node",
      "args": ["/path/to/memory-bank-mcp-x-mdb/dist/index.js"],
      "env": {
        "MONGODB_URI": "your-mongodb-uri",
        "VOYAGE_API_KEY": "your-voyage-key"
      }
    }
  }
}

Memory Structure

The memory bank uses six core files:

  • projectbrief.md - Foundation document
  • productContext.md - Why the project exists
  • activeContext.md - Current work focus
  • systemPatterns.md - Architecture decisions
  • techContext.md - Technology stack
  • progress.md - What works and what's next

Contributing

See CONTRIBUTING.md for development guidelines.

Documentation

License

MIT