Nova Mcp

t stores your project context, decisions, and knowledge locally in SQLite - no cloud, no telemetry. Your data stays on your machine.

GitHub

Nova Memory

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

npm version License: MIT

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)

ToolDescription
store_memoryStore content with type, tags, and path tracking
memory_searchFull-text search with BM25 ranking
memory_queryFilter by type, tags, project, or path
memory_statsStorage statistics and memory counts
memory_deleteRemove memories by ID
memory_tagsList all tags with usage counts
memory_exportExport memories as JSON or markdown
memory_importBulk import memories from JSON

Search Tools (4)

ToolDescription
search_semanticSemantic similarity search
search_patternsFind recurring patterns in memories
search_temporalTime-based memory analysis
search_relationshipsExplore memory connections

Analysis Tools (4)

ToolDescription
analysis_conflictsDetect contradictions between memories
analysis_memory_mapGenerate memory visualization
analysis_anomaliesFind unusual patterns
analysis_forecastPredict memory patterns

Task Tools (3)

ToolDescription
task_managementCreate tasks, phases, track progress
task_boardVisual overview of pending/active/completed
task_insightsAI-powered task analytics

Advanced Tools (2)

ToolDescription
knowledge_graphBuild and query relationship graphs
project_profileStore project architecture and stack info

Maintenance Tools (1)

ToolDescription
memory_compactOptimize 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

ModeDescription
projectStore in .nova/memory.db (default)
globalStore in ~/.nova-memory/memory.db
multiQuery 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

Links

  • npm package
  • GitHub repository
  • Report issues

License

MIT

Máy chủ liên quan