deusdata avatar

Codebase Memory

deusdata/codebase-memory-mcp

A persistent knowledge graph for your codebase that survives restarts and context window limits. Built on tree-sitter AST parsing across 158 languages with hybrid LSP semantic resolution for Python, TypeScript, Go, C#, PHP, C, and C++. Indexes the Linux kernel in 3 minutes, answers structural queries in under 1ms. Ships as a single static binary with 14 MCP tools: search functions and classes, trace call chains, detect dead code, run Cypher queries, analyze impact and architecture. Auto-installs for Claude Code, Zed, Aider, VS Code, and seven other agents. Optional 3D graph UI at localhost. One structural query replaces dozens of file reads, cutting token usage by 120x on navigation tasks.

GitHub stars
48.2K
tools
17
transport
STDIO
last updated
Oct 17, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

index_repositoryIndex a repository into the graph. A successful call from an active MCP session registers the target for auto-sync while that session remains connected (under `daemon start`, also after it disconnects), subject to the global `auto_watch` setting; CLI calls do not register watc...

Index a repository into the graph. A successful call from an active MCP session registers the target for auto-sync while that session remains connected (under `daemon start`, also after it disconnects), subject to the global `auto_watch` setting; CLI calls do not register watc...

No parameter schema in public metadata yet.

list_projectsList indexed projects with paging; use `detail: "stats"` for node/edge counts and database sizes.

List indexed projects with paging; use `detail: "stats"` for node/edge counts and database sizes.

No parameter schema in public metadata yet.

delete_projectRemove a project and all its graph data, including its ADR sidecar (`<db>.adr.db`).

Remove a project and all its graph data, including its ADR sidecar (`<db>.adr.db`).

No parameter schema in public metadata yet.

index_statusCheck indexing status of a project.

Check indexing status of a project.

No parameter schema in public metadata yet.

check_index_coverageCheck whether exact paths or a scope are indexed and fresh. A clean result means no recorded gap, not proof of completeness.

Check whether exact paths or a scope are indexed and fresh. A clean result means no recorded gap, not proof of completeness.

No parameter schema in public metadata yet.

search_graphStructural, BM25, and semantic search. Page structural rows with `offset`/`limit` and ranked semantic rows independently with `semantic_offset`/`semantic_limit`.

Structural, BM25, and semantic search. Page structural rows with `offset`/`limit` and ranked semantic rows independently with `semantic_offset`/`semantic_limit`.

No parameter schema in public metadata yet.

trace_pathTrace callers, callees, data flow, or cross-service paths (alias: `trace_call_path`). Depth 1 to 15; tests are excluded by default.

Trace callers, callees, data flow, or cross-service paths (alias: `trace_call_path`). Depth 1 to 15; tests are excluded by default.

No parameter schema in public metadata yet.

detect_changesMap git diff to affected symbols + blast radius with risk classification.

Map git diff to affected symbols + blast radius with risk classification.

No parameter schema in public metadata yet.

query_graphExecute Cypher-like graph queries (read-only).

Execute Cypher-like graph queries (read-only).

No parameter schema in public metadata yet.

get_graph_schemaNode/edge counts, relationship patterns, property definitions per label. Run this first.

Node/edge counts, relationship patterns, property definitions per label. Run this first.

No parameter schema in public metadata yet.

compare_graphsCompare two indexed snapshots: node/edge additions and removals between a base and a target.

Compare two indexed snapshots: node/edge additions and removals between a base and a target.

No parameter schema in public metadata yet.

get_code_snippetRead source code for a function by qualified name.

Read source code for a function by qualified name.

No parameter schema in public metadata yet.

get_file_outlineDeclaration outline of one repository-relative file in source order, with optional label filter and paging.

Declaration outline of one repository-relative file in source order, with optional label filter and paging.

No parameter schema in public metadata yet.

get_architectureCodebase overview: languages, packages, routes, hotspots, clusters, ADR.

Codebase overview: languages, packages, routes, hotspots, clusters, ADR.

No parameter schema in public metadata yet.

search_codeGrep-like text search within indexed project files.

Grep-like text search within indexed project files.

No parameter schema in public metadata yet.

manage_adrCRUD for Architecture Decision Records (`get` reads, `update` replaces the whole document, `set_sections` rewrites only the named sections and leaves every other byte untouched, `sections` lists headings).

CRUD for Architecture Decision Records (`get` reads, `update` replaces the whole document, `set_sections` rewrites only the named sections and leaves every other byte untouched, `sections` lists headings).

No parameter schema in public metadata yet.

ingest_tracesStore observed call paths or caller/callee pairs under a run label. Both endpoints must resolve to indexed symbols; unresolved names are reported.

Store observed call paths or caller/callee pairs under a run label. Both endpoints must resolve to indexed symbols; unresolved names are reported.

No parameter schema in public metadata yet.

Sponsors

Readme

codebase-memory-mcp: local code intelligence for AI agents via MCP


View the full README on GitHub

Details

Repository
github.com/deusdata/codebase-memory-mcp
Website
deusdata.github.io/codebase-memory-mcp
Categories
AI & LLM Tools, Documents & Knowledge
Package
codebase-memory-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1builderio avatarAgent-Native Assetsbuilderio/agent-nativeDigital asset manager - upload, organize, search, and generate on-brand images and videos7.6Kstars
2builderio avatarAgent-Native Brainbuilderio/agent-nativeCited company knowledge from Slack, meetings, transcripts, and decisions7.6Kstars
3builderio avatarAgent-Native Calendarbuilderio/agent-nativeAgent-Native Google Calendar - manage events, sync, and public booking7.6Kstars
4builderio avatarAgent-Native Chatbuilderio/agent-nativeMinimal chat-first app with durable threads, actions, and the app-agent loop7.6Kstars
5builderio avatarAgent-Native Clipsbuilderio/agent-nativeScreen recording, meeting notes, and voice dictation - all with AI7.6Kstars
6builderio avatarAgent-Native Contentbuilderio/agent-nativeOpen-source Obsidian for MDX - edit local docs with agent assistance7.6Kstars