CodeLore MCP
Stop burning tokens re-reading whole codebases. CodeLore maintains curated, two-perspective docs for LLMs to inspect targeted project knowledge instantly.
Every topic is documented from two perspectives:
internal.md: How the code works under the hood.usage.md: How to use it (API contracts, code snippets, recipes).
⚡ Key Highlights
- 4-Level Hierarchy:
Project→Category(technology) →Chapter(feature) →Topic(doc unit). - Source Freshness Engine: SHA-256 fingerprinting tracks your source files. If code changes on disk, CodeLore flags drift automatically.
- Strict Search Gating:
search_docshard-blocks queries on out-of-sync domains to prevent LLMs from reading stale indexes. - Token-Saving Resync:
resync(action: "mark_valid")updates fingerprints after manual verification without rewriting doc bodies. - Soft-Delete Archive:
removemoves entities to archive with a 30-day auto-expiry sweep.archiveshelves indefinitely.restorerecovers anytime.
🛠️ MCP Tools
🚀 Quick Start
Add to Claude Code (user scope):
claude mcp add --scope user codelore -- npx -y codelore-mcp
Or add to any .mcp.json:
{
"mcpServers": {
"codelore": {
"command": "npx",
"args": ["-y", "codelore-mcp"]
}
}
}
Storage Location
Docs live in ~/.codelore by default. To set a custom directory, pass --root:
{
"mcpServers": {
"codelore": {
"command": "npx",
"args": ["-y", "codelore-mcp", "--root", "D:\\docs\\.codelore"]
}
}
}
🛠️ Development
npm install
npm run build # Compile TypeScript to dist/
npm run dev # Run with tsx live
📄 License
MIT © Paul Benchea