neuralmind.uk / NeuralMind vs. codebase-memory-mcp — breadth and raw speed, or ranking quality and a graph that learns? Edit this page on GitHub ↗

NeuralMind vs. codebase-memory-mcp

TL;DR — This is the one competitor we have scored live, on pinned repos, with committed traces. At matched retrieval depth (top-8), on the two repos that eval covers, NeuralMind ranked the objectively-correct file far higher (MRR 0.96 vs. 0.23 on requests) at roughly an order of magnitude fewer tokens. That result is real, reproducible, and narrower than it sounds — two repos, pure retrieval ranking with no agent loop on either side, and not re-verified against our current four-repo corpus. Meanwhile codebase-memory-mcp beats us decisively on breadth and scale: 162 vendored languages to our 10, a single static C binary with no language runtime, and the Linux kernel fully indexed in about three minutes. Pick on which of those axes your repo actually lives. Assessed September 2026 against version 0.8.1 — re-check before relying on specifics.

What codebase-memory-mcp is

codebase-memory-mcp (MIT) is a native C executable that runs as an MCP server, indexing a repo into a persistent knowledge graph. Its indexing pipeline stacks three techniques:

Storage is SQLite compressed with zstd. It exposes 15 MCP tools, including search_graph, semantic_query, trace_path, get_architecture, query_graph (Cypher-like traversal), manage_adr and ingest_traces. There’s a built-in 3D graph viewer on localhost:9749.

Its performance figures are genuinely impressive and we cite them as published: the Linux kernel (28M LOC, 75K files) indexed in ~3 minutes to 4.81M nodes and 7.72M edges; Django in ~6s; Cypher queries under 1ms. It reports 83% answer quality with 10× fewer tokens across 31 repositories, and a 99.2% token reduction on a five-query structural comparison.

Critically for the comparison below: it does not learn. Indexing is static analysis; a file watcher triggers re-indexing on change, but nothing reweights from how the codebase is actually used.

The scored head-to-head

Unlike every other page in this directory, this one has numbers from a run rather than a capability table. We drove both tools headless over the same pinned repos, same questions, same objective def-site gold files, scored by the same quality.py, at retrieval depth matched to our embedding-rag baseline (top-8).

repo backend gold-file recall found-rate MRR (rank quality) mean tokens
requests codebase-memory-mcp 0.50 43% 0.23 25,214
requests neuralmind 1.00 100% 0.96 1,095
click codebase-memory-mcp 0.64 57% 0.50 38,538
click neuralmind 1.00 100% 0.60 924

Reproduce it yourself:

pip install codebase-memory-mcp==0.8.1
python -m evals.public.competitor

Raw per-query traces, results.json, and pinned provenance are committed under bench/public/competitor/.

The fairness terms matter as much as the numbers:

How NeuralMind differs architecturally

Beyond ranking, two structural differences:

1. It learns; codebase-memory-mcp doesn’t. Our synapse layer applies Hebbian reinforcement to edges that co-activate during real queries and edits, with exponential half-life decay so stale associations fade. The competitor’s graph is a faithful snapshot of the code and stays one.

2. Progressive disclosure vs. query-per-tool. We serve L0→L3 slices (~600 tokens at wake-up, ~500–1000 per query) sized to the question. It exposes 15 tools the agent chooses among — more expressive for structural questions like trace_path or get_architecture, and more dependent on the agent picking well.

Dimension codebase-memory-mcp NeuralMind
Distribution Single static C binary, no runtime Python package (PyPI), Docker, VS Code extension
Languages 162 vendored grammars (~31 benchmarked, quality-tiered) 10 tree-sitter, Python-first eval coverage
Type resolution Hybrid LSP for ~10 major languages Heuristic by default; SCIP precision opt-in (Python/TS/Go)
Embeddings Bundled nomic-embed-code, compiled in MiniLM ONNX, downloaded on first build
Scale ceiling Linux kernel (28M LOC) in ~3 min Tuned for single-project repos, not kernel-scale monorepos
Query latency Sub-ms Cypher traversal Slower — vector + graph, Python
Tool surface 15 MCP tools incl. Cypher traversal, ADR management MCP tools + Claude Code lifecycle hooks
Learns from usage No Yes — Hebbian reinforcement with half-life decay
Tool-output compression No No (its PostToolUse hooks on Read/Bash/Grep used to; measured, that added tokens — benchmark)
Team memory Per-machine cache Git-portable .neuralmind-team-memory.json
Retrieval ranking (our eval) MRR 0.23 / 0.50 MRR 0.96 / 0.60
License MIT MIT (core); source-available commercial modules for the Team tier

When to pick which

Pick codebase-memory-mcp if:

Pick NeuralMind if:

The honest caveats

See also