Memory Server

•
6
•

Enables Claude to maintain context and knowledge across chat sessions by managing project-specific memories.

Memory Server is a Model Context Protocol (MCP) server designed for Claude Desktop that provides structured memory management for project-based work. It allows Claude to create memory stores within project directories, save important information from conversations, and retrieve relevant memories in future sessions. This facilitates building a comprehensive knowledge base about a project over time, ideal for long-term endeavors like software development, research, or collaborative writing.

Características Principales

01Indexes memories using Lunr.js for efficient retrieval
02Creates relationships between memories
03Stores memories as structured markdown files
04Searches memories by content, tags, or type
05Tags and categorizes memories

Casos de Uso

01Collaborative writing efforts benefitting from shared memory
02Research projects needing knowledge base building
03Software development projects requiring persistent context

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

  1. Setup: When starting a new project with Claude, have it create a memory store in your project directory
  2. Ongoing Work: As you work with Claude, it will save important information to the memory store
  3. Continuity: In future sessions, Claude can retrieve relevant memories to maintain context
  4. 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