MCP Memory Server

by ebailey78

Integrations

  • Stores memories as structured markdown files in a hierarchical organization system with support for categorization and relationships between memories.

  • Uses TypeScript for type safety in the implementation of the memory management system.

  • Utilizes Zod for schema validation of memory structures.

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

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.

  1. Project-Focused Memory Management
    1. Features
      1. Memory Structure
        1. Usage with Claude Desktop
          1. Project Workflow
            1. Claude Project Instructions
              1. Development
                1. Implementation Details
                  1. License

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that enables Claude Desktop users to interact directly with PostHog, allowing them to view projects and create annotations through natural language commands.
                      Last updated -
                      2
                      10
                      Python
                      MIT License
                      • Apple
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
                      Last updated -
                      2
                      14
                      TypeScript
                      MIT License
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that enables AI assistants like Claude to interact with Zulip workspaces, supporting capabilities such as posting messages, listing channels, sending direct messages, and accessing conversation history.
                      Last updated -
                      JavaScript
                      Apache 2.0
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that allows Claude Desktop to manage and execute tasks in a queue-based system, supporting planning, execution, and completion phases.
                      Last updated -
                      322
                      2
                      TypeScript
                      MIT License
                      • Apple

                    View all related MCP servers

                    ID: pqd0je4v10