Memory MCP Server

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