Cursor Memory MCP Server

A persistent memory storage MCP (Model Context Protocol) server for Cursor IDE. Allows the AI assistant to remember information across sessions.

Features

• Store memories with global or project-specific scope

• Tag-based organization for easy categorization

• Search memories by content or tags

• CRUD operations - create, read, update, delete memories

• Context matching - update/delete by description, not just ID

• SQLite backend for performance and reliability

• Docker deployment for easy setup

Quick Start

1. Build and Run with Docker

docker-compose up -d --build

2. Add to Cursor MCP Configuration

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cursor-memory": {
      "url": "http://localhost:8081/sse",
      "transport": "sse"
    }
  }
}

3. Restart Cursor

The memory tools will now be available to the AI assistant.

Available Tools

Usage Examples

Storing a Memory

Tell Cursor: "Remember that I prefer tabs over spaces"

The agent will:

1. Optimize the content

2. Ask for scope (global/project)

3. Suggest tags

4. Confirm before storing

Recalling Memories

Tell Cursor: "Check your memory" or "What do you remember?"

Searching Memories

Tell Cursor: "Check your memory for coding preferences"

Managing Memories

• "List all memories"

• "Delete memory #3"

• "Update the memory about indentation to prefer 4 spaces"

Development

Local Development (without Docker)

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build
npm start

Environment Variables

Architecture

┌─────────────────┐     SSE      ┌──────────────────────┐
│   Cursor IDE    │◄────────────►│  Memory MCP Server   │
│   (AI Agent)    │              │  (Express + SQLite)  │
└─────────────────┘              └──────────────────────┘
                                           │
                                           ▼
                                    ┌─────────────┐
                                    │  SQLite DB  │
                                    │  memory.db  │
                                    └─────────────┘

Port Configuration

This server runs on port 8081 by default to avoid conflicts with other MCP servers (e.g., jana on 8080).

License

MIT