Who codebase-memory-mcp is for#
AI Developers
Ideal for developers using AI coding agents to enhance productivity.
Skip if:
Not using AI coding agents.
Codebase Managers
Useful for teams managing large codebases needing quick insights.
Skip if:
Working with small, simple codebases.
The problem it solves#
AI coding agents often waste tokens and time exploring codebases by reading files one at a time. This project provides a solution by indexing codebases into a knowledge graph, allowing for efficient querying.
How it solves it#
Fast Indexing
Indexes an average repository in seconds and the Linux kernel in 3 minutes.
Token Efficiency
Reduces token usage by ~120x for structural queries compared to file-by-file exploration.
Multi-Language Support
Supports 158 programming languages with tree-sitter parsing.
Local Processing
All processing happens locally, ensuring code privacy.
3D Graph Visualization
Interactive UI for exploring the knowledge graph.
Cross-Service Linking
Matches REST routes to HTTP call sites across services.
Strengths and trade-offs#
Strengths
- High EfficiencySignificantly reduces the number of tokens used for queries.
- SpeedFast indexing and querying capabilities.
- Local OperationNo external dependencies or API keys required.
- Wide Language SupportCompatible with a large number of programming languages.
Trade-offs
- -No Built-in LLMRelies on external agents for natural language processing.
- -Initial Setup RequiredRequires initial indexing which may take time for large codebases.
Quick start#
Install the local MCP server on macOS or Linux, then restart your coding agent so it can detect the new MCP configuration. The upstream one-line installer is available, or you can clone the repository and run the installer after review.
```bash
git clone https://github.com/DeusData/codebase-memory-mcp.git
cd codebase-memory-mcp
./install.sh
codebase-memory-mcp config set auto_index true
```
For Windows, download the PowerShell installer from the project repository, inspect it, and run `.\install.ps1`. Use `--ui` on supported releases when you also want the local graph visualization server.What it's built on#
- Languages
- CC++Python
- Frameworks
- React
- Databases
- SQLite
FAQ#
Does codebase-memory-mcp send my code anywhere?
No, all processing happens locally.
Is it free and open source?
Yes, it is MIT licensed and available on GitHub.
How do I install codebase-memory-mcp?
Use the one-line install command: curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash.
Similar open-source tools#
monocode
One desktop UI for all your AI coding agents.
Superlearn
Interactive study boards for any topic, no new subscription needed
garden-skills
Production-ready agent skills for Claude Code, Cursor, and Codex
fx
Native Zig CLI coding agent, 7.8 MiB, any AI model.
codex
OpenAI's terminal coding agent, Apache-2.0 licensed
kilocode
Open source AI coding agent. 500+ models at zero markup.