@nova-mcp/mcp-nova

v1.0.3

Published

2 months ago

Zero-config AI project memory with live file watching and MCP integration

Nova Memory

Local-first persistent memory for AI assistants. Store context across sessions with SQLite.

What is Nova Memory?

Nova Memory is an MCP (Model Context Protocol) server that gives AI assistants persistent memory. It stores your project context, decisions, and knowledge locally in SQLite - no cloud, no telemetry. Your data stays on your machine.

Features

22 MCP tools for memory, search, analysis, and task management
Store and search memories with BM25 full-text search
Knowledge graph with relationship traversal
Task management with phases and progress tracking
Multi-project support with cross-project queries
Enable/disable individual tools via configuration
Complete TypeScript implementation with Zod validation

Installation

npm install -g @nova-mcp/mcp-nova

Setup

Claude Desktop

Add to your config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nova-memory": {
      "command": "npx",
      "args": ["@nova-mcp/mcp-nova"]
    }
  }
}

Claude Code

claude mcp add nova-memory -- npx @nova-mcp/mcp-nova

Available Tools

Memory Tools (8)

| Tool | Description | |------|-------------| | store_memory | Store content with type, tags, and path tracking | | memory_search | Full-text search with BM25 ranking | | memory_query | Filter by type, tags, project, or path | | memory_stats | Storage statistics and memory counts | | memory_delete | Remove memories by ID | | memory_tags | List all tags with usage counts | | memory_export | Export memories as JSON or markdown | | memory_import | Bulk import memories from JSON |

Search Tools (4)

| Tool | Description | |------|-------------| | search_semantic | Semantic similarity search | | search_patterns | Find recurring patterns in memories | | search_temporal | Time-based memory analysis | | search_relationships | Explore memory connections |

Analysis Tools (4)

| Tool | Description | |------|-------------| | analysis_conflicts | Detect contradictions between memories | | analysis_memory_map | Generate memory visualization | | analysis_anomalies | Find unusual patterns | | analysis_forecast | Predict memory patterns |

Task Tools (3)

| Tool | Description | |------|-------------| | task_management | Create tasks, phases, track progress | | task_board | Visual overview of pending/active/completed | | task_insights | AI-powered task analytics |

Advanced Tools (2)

| Tool | Description | |------|-------------| | knowledge_graph | Build and query relationship graphs | | project_profile | Store project architecture and stack info |

Maintenance Tools (1)

| Tool | Description | |------|-------------| | memory_compact | Optimize and compact storage |

Configuration

Create .nova/config.json in your project root:

{
  "storage": {
    "mode": "project"
  },
  "features": {
    "taskManagement": true,
    "knowledgeGraph": true
  },
  "tools": {
    "search_patterns": true,
    "analysis_conflicts": true,
    "project_profile": true
  }
}

Storage Modes

| Mode | Description | |------|-------------| | project | Store in .nova/memory.db (default) | | global | Store in ~/.nova-memory/memory.db | | multi | Query across multiple project databases |

Multi-Project Configuration

{
  "storage": {
    "mode": "multi",
    "multiProject": {
      "enabled": true,
      "includePaths": ["~/projects/api", "~/projects/web"]
    }
  }
}

Storage Location

All data stored locally in SQLite:

Project mode: .nova/memory.db in project root
Global mode: ~/.nova-memory/memory.db in home directory

No cloud services. No external API calls. No telemetry.

Troubleshooting

Tools not showing: Restart Claude Desktop/Code after installation
Command not found: Run npm install -g @nova-mcp/mcp-nova or check PATH
NVM users: Use full path to node in MCP config
Permission errors: Ensure write access to .nova or home directory
Version check: Run mcp-nova --version to verify installation

License

MIT