# 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
```bash
docker-compose up -d --build
```
### 2. Add to Cursor MCP Configuration
Edit `~/.cursor/mcp.json`:
```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
| Tool | Description |
|------|-------------|
| `memory_store` | Store a new memory |
| `memory_recall` | Retrieve all memories (call on session start) |
| `memory_search` | Search memories by keyword/tag |
| `memory_list` | List all memories with index numbers |
| `memory_update` | Update a memory by ID or context |
| `memory_delete` | Delete a memory by ID or context |
## 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)
```bash
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
npm start
```
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | `8081` | HTTP server port |
| `DATA_DIR` | `./data` | SQLite database directory |
| `NODE_ENV` | `development` | Environment mode |
## 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
