Code Memory MCP server
io.github.kapillamba4/code-memory·v1.0.33·49 starsLocal semantic code search with Git history. Works offline, no API key needed.
49 stars
Reviews
Write oneNobody has reviewed Code Memory yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Code Memory tools (7)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_index_statusUSE THIS TOOL to check if the codebase has been indexed and whether search tools will return results. Call this BEFORE search_code or search_docs if you're unsure about indexing state.
find_dead_codeget_index_statsUSE THIS TOOL to get comprehensive statistics about the code index.
index_codebaseYOU MUST CALL THIS TOOL FIRST before using search_code or search_docs. Use this tool to build the searchable index that powers all other code intelligence features.
search_codesearch_docsUSE THIS TOOL for conceptual understanding and "how does X work?" questions. Search markdown documentation, READMEs, and code docstrings using semantic search.
search_historyUSE THIS TOOL for Git history queries: understanding WHY changes were made, debugging regressions, or finding commit context. This tool operates on the local Git repository.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan17 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 130 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Code Memory compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 60% of 1,119 Developer tools servers
- Tools
- 7
- the typical Developer tools server has 7
- Tools that change things
- 0%
- typical: 5%. Fewer write tools means less an agent can break
- GitHub stars
- 49
- more than 91% of 855 Developer tools servers
What its tools let an agent do: 7 read
Install Code Memory in Claude Code, Cursor or VS Code
claude mcp add code-memory -- uvx code-memory
What the publisher says
From the Code Memory repository's README, as published. We do not edit it. Read it on GitHub
code-memory
<!-- mcp-name: io.github.kapillamba4/code-memory -->
A deterministic, high-precision code intelligence layer exposed as a Model Context Protocol (MCP) server.
- Zero telemetry — your code never leaves your machine
- No API key required — runs entirely locally with sentence-transformers
- 1 min setup — just uvx code-memory and you're ready
- Token saving by 50% — precise code retrieval instead of dumping entire files
Please help star code-memory if you like this project!
Why code-memory?
Finding the right context from a large codebase is expensive, inaccurate, and limited by context windows. Dumping files into prompts wastes tokens, and LLMs lose track of the actual task as context fills up.
Instead of manually hunting with grep/find or dumping raw file text, code-memory runs semantic searches against a locally indexed codebase. Inspired by claude-context, but designed from the ground up for large-scale local search.
Supported Languages
Full AST Support (structural parsing with symbol extraction): Python, JavaScript/TypeScript, Java, Go, Rust, C/C++, Ruby, Kotlin
Fallback Support (whole-file indexing): C#, Swift, Scala, Lua, Shell, Config (yaml/toml/json), Web (html/css), SQL, Markdown
Files matching .gitignore patterns are automatically skipped.
Architecture: Progressive Disclosure
Instead of a single monolithic search, code-memory routes queries through three purpose-built tools:
This forces the LLM to pick the right retrieval strategy before any data is fetched.
Installation
From PyPI (Recommended)
# Install with pip
pip install code-memory
# Or with uvx (for MCP hosts)
uvx code-memoryFrom Source
# Clone the repo
git clone https://github.com/kapillamba4/code-memory.git
cd code-memory
# Install dependencies
uv sync
# Run the MCP server (stdio transport)
uv run mcp run code_memory/server.pyPre-built Binaries (Standalone)
Download standalone executables from GitHub Releases — no Python installation required.
# Linux/macOS: Download and make executable
chmod +x code-memory-*
./code-memory-*
# Windows: Run directly
code-memory-windows-x86_64.exeNote: The first run will download the embedding model (~600MB) to ~/.cache/huggingface/. Subsequent runs use the cached model.
Quickstart
Prerequisites
- Python ≥ 3.13
- uv package manager (recommended) or pip
Install uv if you don't have it:
curl -LsSf https://astral.sh/uv/install.sh | shInstall & Run
# Install from PyPI
pip install code-memoryShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Code Memory: common questions
- Is Code Memory MCP server safe?
- Mostly: it is graded B (82/100). Read the Code Memory safety report
- How do I install Code Memory?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Code Memory need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Code Memory maintained?
- The last commit was 168 days ago (2026-05-20). The latest release is v1.0.33.
- What can I use instead of Code Memory?
- Servers from other publishers that do the same job: Nexusmem MCP server, Repowise MCP server and Palinode MCP server.
- How does Code Memory compare with other Developer tools MCP servers?
- safety score 82/100 (higher than 60% of 1,119 Developer tools servers); tools 7 (the typical Developer tools server has 7); tools that change things 0% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Code Memory
Same job from other publishers: the closest match first, then the best rated.
- NexusmemLocal-first memory for AI coding agents: shell history with exit codes, git diffs, docs, MCP.not reviewedGrowingA
RepowiseCodebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.not reviewedEstablishedB- PalinodeInspectable, correctable project memory in git-versioned Markdown for AI agents.not reviewedEstablishedC
- SoloMDRead and search a folder of Markdown notes: search, backlinks, tags, tasks, outlines, git history.not reviewedEstablishedB
- argotRead-only context and complete checks against patterns learned from git history. Local; no LLM.not reviewedEstablishedB