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.
Install and self-host#
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++TypeScript
- 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#
orca
The ultimate IDE for coding agents
agentmemory
Persistent memory for AI coding agents
superpowers
Skill-based workflows for coding agents
Agent Skills
Structured workflows for AI coding agents.
Flue Framework
Build powerful, autonomous agents with TypeScript.
9Router
Smart AI Router with 3-Tier Fallback