localnest — plugin by wmt-mobile

LocalNest is a comprehensive MCP server that combines code intelligence, a knowledge graph, and persistent AI memory in a single local package.

<h1 align="center">LocalNest MCP</h1> Code Intelligence + Knowledge Graph + AI Memory — One Local MCP Server <a href="https://www.npmjs.com/package/localnest-mcp"><img src="https://img.shields.io/npm/v/localnest-mcp.svg?style=for-the-badge&color=success" alt="npm version"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-gold.svg?style=for-the-badge" alt="License: MIT"></a> <a href="https://github.com/wmt-mobile/localnest/actions/workflows/quality.yml"><img src="https://img.shields.io/github/actions/workflow/status/wmt-mobile/localnest/quality.yml?branch=main&style=for-the-badge&label=Quality" alt="Quality"></a> The only MCP server that unifies semantic code search, a temporal knowledge graph, and persistent AI memory in a single local-first package. 74 tools. Zero cloud. Pure SQLite.

Why LocalNest?

Every other MCP server forces you to choose: memory or code intelligence. Never both.

LocalNest is the first to combine all three pillars into one server that runs entirely on your machine:

Pillar	What it does	Why it matters
Code Intelligence	Hybrid BM25+vector search, AST-aware chunking, symbol finding (defs/usages/callers)	Your AI understands code structure, not just text
Knowledge Graph	Temporal entity-triple store with multi-hop traversal and `as_of` time-travel queries	Architectural decisions, dependencies, and facts — versioned over time
Persistent Memory	Cross-session recall, semantic dedup, agent-scoped isolation, conversation ingestion	Your AI remembers what you taught it — forever

How LocalNest Compares

No other MCP server covers all three pillars. Here's how the landscape breaks down:

vs Memory-Only Servers

	LocalNest	Mem0	Basic Memory	MCP Memory Service	AgentMemory
Persistent AI memory	Yes	Yes	Yes	Yes	Yes
Knowledge graph	Yes	No	No	No	No
Semantic code search	Yes	No	No	No	No
Symbol finding (defs/usages)	Yes	No	No	No	No
AST-aware chunking	Yes	No	No	No	No
Local-first / no cloud	Yes	Hybrid	Yes	Yes	Yes
MCP tools	74	8	~10	24	43

Mem0 has 41k stars and $24M in funding — but it's memory-only with no code intelligence. Basic Memory integrates with Obsidian but can't search code. AgentMemory has auto-capture hooks but zero code features.

vs Code Intelligence Servers

	LocalNest	GitNexus	claude-context	codebase-memory-mcp	CodeGraphContext
Semantic code search	Yes	Yes	Yes	Yes	Yes
Knowledge graph	Yes	Code-only	No	Code-only	Yes
Persistent AI memory	Yes	No	No	No	No
Cross-session recall	Yes	No	No	No	No
Symbol finding	Yes	Yes	No	Yes	Yes
Temporal time-travel queries	Yes	No	No	No	No
Conversation ingestion	Yes	No	No	No	No
Local-first / no cloud	Yes	Yes	Partial	Yes	Yes
MCP tools	74	16	~5	14	~10

GitNexus (27k stars) has strong code search but no memory. claude-context (Zilliz, 5.9k stars) is Milvus-backed with no KG or memory. codebase-memory-mcp (DeusData) is the closest competitor — code + KG in a single binary — but has no AI memory layer.

Full Feature Matrix

Feature	LocalNest	codebase-memory-mcp	GitNexus	claude-context	Basic Memory	Mem0
Semantic code search (hybrid BM25+vec)	Yes	Yes	Yes	Yes	No	No
Knowledge graph (entities + triples)	Yes	Code-only	Code-only	No	No	No
Persistent AI memory	Yes	No	No	No	Yes	Yes
Symbol finding (defs/usages/callers)	Yes	Yes	Yes	No	No	No
AST-aware chunking	Yes	Yes	Yes	Yes	No	No
Temporal time-travel queries	Yes	No	No	No	No	No
Multi-hop graph traversal	Yes	No	No	No	No	No
Conversation ingestion	Yes	No	No	No	No	No
Agent-scoped isolation	Yes	No	No	No	No	No
Semantic dedup	Yes	No	No	No	No	No
Hooks system (pre/post callbacks)	Yes	No	No	No	No	No
Interactive TUI dashboard	Yes	No	No	No	No	No
Local-first / no cloud	Yes	Yes	Yes	Partial	Yes	Hybrid
MCP tools	74	14	16	~5	~10	8
Zero external deps	No (Node.js)	Yes (binary)	No	No	No	No

LocalNest is the only server that checks every box in the first three rows.

Quick Start

# Install
npm install -g localnest-mcp

# Setup workspace + embeddings
localnest setup

# Verify
localnest doctor

Interactive dashboard:

localnest dashboard

MCP Client Config

After setup, add this to your AI client config:

{
  "mcpServers": {
    "localnest": {
      "command": "localnest-mcp",
      "startup_timeout_sec": 30,
      "env": {
        "MCP_MODE": "stdio",
        "LOCALNEST_CONFIG": "~/.localnest/config/localnest.config.json",
        "LOCALNEST_INDEX_BACKEND": "sqlite-vec",
        "LOCALNEST_MEMORY_ENABLED": "true"
      }
    }
  }
}

Works with Claude Code, Cursor, Windsurf, Cline, Continue, Gemini CLI, and any MCP-compatible client.

Tool Suites

LocalNest exposes 74 specialized MCP tools, organized into focused suites:

<details> <summary>Workspace & Discovery — file navigation, project summaries, scoped reads</summary> <code>project_tree</code>, <code>read_file</code>, <code>file_changed</code>, <code>list_projects</code>, <code>list_roots</code>, <code>summarize_project</code> </details> <details> <summary>Search & Code Intelligence — hybrid search, symbols, AST-aware queries</summary> <code>search_hybrid</code>, <code>search_code</code>, <code>search_files</code>, <code>find</code>, <code>find_definition</code>, <code>find_usages</code>, <code>find_callers</code>, <code>find_implementations</code>, <code>get_symbol</code>, <code>rename_preview</code> </details> <details> <summary>Memory & Recall — persistent cross-session memory with semantic dedup</summary> <code>memory_store</code>, <code>memory_recall</code>, <code>memory_get</code>, <code>memory_update</code>, <code>memory_delete</code>, <code>memory_list</code>, <code>memory_store_batch</code>, <code>memory_delete_batch</code>, <code>memory_related</code>, <code>memory_suggest_relations</code>, <code>memory_add_relation</code>, <code>memory_remove_relation</code>, <code>memory_capture_event</code>, <code>memory_events</code>, <code>memory_status</code>, <code>memory_check_duplicate</code> </details> <details> <summary>Knowledge Graph — temporal triples, time-travel, multi-hop traversal</summary> <code>kg_add_entity</code>, <code>kg_add_triple</code>, <code>kg_query</code>, <code>kg_invalidate</code>, <code>kg_as_of</code>, <code>kg_timeline</code>, <code>kg_stats</code>, <code>kg_add_entities_batch</code>, <code>kg_add_triples_batch</code>, <code>kg_backfill_links</code>, <code>graph_traverse</code>, <code>graph_bridges</code> </details> <details> <summary>Organization — nests, branches, agent isolation, diary</summary> <code>nest_list</code>, <code>nest_branches</code>, <code>nest_tree</code>, <code>diary_write</code>, <code>diary_read</code> </details> <details> <summary>Ingestion & Hooks — conversation import, lifecycle callbacks</summary> <code>ingest_markdown</code>, <code>ingest_json</code>, <code>hooks_stats</code>, <code>hooks_list_events</code> </details> <details> <summary>Agent Context — priming, teaching, outcomes, task context</summary> <code>agent_prime</code>, <code>teach</code>, <code>capture_outcome</code>, <code>task_context</code>, <code>whats_new</code> </details> <details> <summary>System — health, indexing, updates, embedding status</summary> <code>health</code>, <code>server_status</code>, <code>index_project</code>, <code>index_status</code>, <code>embed_status</code>, <code>update_self</code>, <code>update_status</code>, <code>audit</code>, <code>backup</code>, <code>restore</code>, <code>help</code>, <code>usage_guide</code> </details>

Full parameter reference: Tool Documentation

Agentic Workflows

LocalNest is designed as the foundational context layer for AI coding agents:

Cold start — agent_prime instantly hydrates the context window with relevant memories, recent changes, and project state.
Deep investigation — find runs fused search across code fragments and historical design decisions in a single call.
Continuous learning — teach saves architectural rules that persist across sessions, ensuring agents never repeat mistakes.
Outcome capture — capture_outcome records what worked and what didn't, building an experience base over time.

Enterprise-Grade Quality

OIDC Trusted Publishing for verifiable npm provenance
Continuous CodeQL static analysis on all branches
OpenSSF Scorecard monitoring and proactive Dependabot updates

Troubleshooting

<details> <summary>Installing from GitHub fails</summary>

Direct npm install -g git+https://... may fail with TAR_ENTRY_ERRORS. This is a known npm limitation.

Fix: clone, pack, install

git clone https://github.com/wmt-mobile/localnest.git
cd localnest && npm pack
npm install -g ./localnest-mcp-*.tgz

</details> <details> <summary>Semantic search not working</summary>

cd $(npm root -g)/localnest-mcp && npm install --no-save @huggingface/transformers
localnest doctor

</details>

Resources

Documentation — Full tool reference, architecture, and guides
Comparison — Detailed competitive analysis
Architecture — Retrieval pipeline and memory graph internals
Changelog — Release history
Security — Vulnerability disclosure policy

<div align="center"> Code intelligence. Knowledge graph. AI memory. One server. Your machine. </div>