Memory MCP Server

A long-term memory storage system for LLMs using the Model Context Protocol (MCP) standard. This system helps LLMs remember the context of work done over the entire history of a project, even across multiple sessions. It uses semantic search with embeddings to provide relevant context from past interactions and development decisions.

Features

• Project-based memory organization

• Semantic search using Ollama embeddings (nomic-embed-text model, 768 dimensions)

• Multiple memory types:

  • Conversations: Dialog context and important discussions

  • Code: Implementation details and changes

  • Decisions: Key architectural and design choices

  • References: Links to external resources and documentation

• Rich metadata storage including:

  • Implementation status

  • Key decisions

  • Files created/modified

  • Code changes

  • Dependencies added

• Tagging system for memory organization

• Relationship tracking between memories

Prerequisites

• Node.js (v18 or later)

• Ollama running locally (for embeddings)

  • Must have the nomic-embed-text model installed

• SQLite3

Installation

1. Clone the repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Create a .env file with required configuration:

   OLLAMA_HOST=http://localhost:11434 DB_PATH=memory.db

Usage

1. Start the server in development mode:

   npm run dev

   This will:

   • Compile TypeScript

   • Copy schema files

   • Start the server with auto-reload

2. The server connects via stdio for Cursor compatibility

Database Schema

The system uses SQLite with the following tables:

Core Tables

• projects: Project information and metadata

• memories: Memory entries storing various types of development context

• embeddings: Vector embeddings (768d) for semantic search capabilities

Organization Tables

• tags: Memory organization tags

• memory_tags: Many-to-many relationships between memories and tags

• memory_relationships: Directed relationships between memory entries

MCP Tools

The following tools are available through the MCP protocol:

Memory Management

• store-dev-memory: Create new development memories with:

  • Content

  • Type (conversation/code/decision/reference)

  • Tags

  • Code changes

  • Files created/modified

  • Key decisions

  • Implementation status

• list-dev-memories: List existing memories with optional tag filtering

• get-dev-memory: Retrieve specific memory by ID

• search: Semantic search across memories using embeddings

Development

For development:

This will:

1. Kill any existing server instances

2. Rebuild the TypeScript code

3. Copy the schema.sql to the dist directory

4. Start the server in development mode

Dependencies

Key dependencies:

• @modelcontextprotocol/sdk@^1.7.0: MCP protocol implementation

• better-sqlite3@^9.4.3: SQLite database interface

• node-fetch@^3.3.2: HTTP client for Ollama API

• zod@^3.22.4: Runtime type checking and validation

Project Structure

Contributing

Contributions are welcome! Please ensure you:

1. Write clear commit messages

2. Add appropriate documentation

3. Follow the existing code style

4. Add/update tests as needed