MCP Memory Server

A Model Context Protocol (MCP) server for Claude Desktop that provides structured memory management across chat sessions, specifically designed for project-based work.

Project-Focused Memory Management

This MCP server is specifically designed to help Claude maintain context and knowledge within project directories when used with Claude Desktop. It allows Claude to:

Create a memory store within your project directory
Save important information discovered during conversations
Retrieve relevant memories in future sessions
Build a comprehensive knowledge base about your project over time

This approach is ideal for long-term projects where maintaining context between sessions is crucial, such as software development, research, writing, or any collaborative work with Claude.

Features

Store memories as structured markdown files
Index memories using Lunr.js for efficient retrieval
Tag and categorize memories
Create relationships between memories
Search memories by content, tags, or type
Build memory stores in specified directories

Memory Structure

Memories are stored in a hierarchical structure within your project:

/your-project-directory
  /memory                # Memory store created by Claude
    /entities/           # Information about specific entities (people, projects, etc.)
    /concepts/           # Abstract concepts or knowledge
    /sessions/           # Session-specific memories
    /index.json          # Lunr.js search index
    /metadata.json       # Overall memory metadata
    /README.md           # Auto-generated documentation

This structure keeps all project-related memories organized and accessible within your project directory.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"]
    }
  }
}

You can also set a custom memory directory using an environment variable:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"],
      "env": {
        "MEMORY_DIR": "/path/to/custom/memory/directory"
      }
    }
  }
}

Project Workflow

Setup: When starting a new project with Claude, have it create a memory store in your project directory
Ongoing Work: As you work with Claude, it will save important information to the memory store
Continuity: In future sessions, Claude can retrieve relevant memories to maintain context
Knowledge Building: Over time, Claude builds a comprehensive knowledge base about your project

This workflow ensures that Claude maintains context and knowledge specific to each project, making it more effective as a long-term collaborator.

Claude Project Instructions

This repository includes an instructions_template.md file that provides a comprehensive template for Claude project instructions. You can customize this template for your specific projects to help Claude effectively use the memory system.

The template includes:

Memory system setup instructions
Memory retrieval process
Memory creation guidelines
Memory organization system
Memory maintenance procedures
Conversation workflow
Best practices

Development

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

# Development mode (watch for changes)
npm run dev

Implementation Details

This server is built using:

The official Model Context Protocol (MCP) SDK
TypeScript for type safety
Lunr.js for memory indexing and search
Zod for schema validation

License

MIT