engram · girishbuilds — Claude Code MCP server: repo memory for agents
Tells your agent which files tend to change together and what the tests expect. Useful before touching unfamiliar code.
claude mcp add engram -- npx -y @spectra-g/engram-adapterWhat engram does
Engram is an MCP server that hands the agent context the files themselves don't carry. It mines git history for files that keep getting committed alongside your target, so a change to A.ts comes with a warning about B.ts. The second layer is tests: it pulls out intent strings such as it("should validate JWT expiration") and passes them along as behavioural guardrails.
Notes are the third layer. The agent calls save_project_note to record what the code doesn't say — field order in an export format, a restart needed after a config change. Those notes then surface on their own in later impact analyses. Three tools in total: get_impact_analysis, save_project_note, read_project_notes.
Everything runs on your machine, with no telemetry. The adapter is a TypeScript server on Node.js, started through npx and speaking stdio. Test framework coverage is uneven: JS/TS (Vitest, Jest, Mocha, Playwright, Cypress), JVM (JUnit 4, JUnit 5, Kotest, ScalaTest), Rust, Python (Pytest, Unittest) and Go. Point it at anything else and no intent strings get collected, which costs you half the value.
What it helps with
- spot hidden coupling between files before editing
- keep a positional parser in another file from breaking
- read test intent without opening the whole suite
- carry project knowledge across agent sessions
- size up the blast radius of one file change
Example prompts for the agent
- Run an impact analysis on
src/Auth.tswith engram - Save a project note: the export line format is parsed positionally by
bin/legacy-mainframe-sync.js - Search project notes for Redis
How to install engram
Platform CLI
claude mcp add engram -- npx -y @spectra-g/engram-adapterPlatform CLI
codex mcp add adapter -- npx -y @spectra-g/engram-adapterConfig file
{
"mcpServers": {
"adapter": {
"command": "npx",
"args": [
"-y",
"@spectra-g/engram-adapter"
]
}
}
}Config file
{
"servers": {
"adapter": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@spectra-g/engram-adapter"
]
}
}
}Platform CLI
gemini mcp add adapter npx -y @spectra-g/engram-adapterStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about engram
How do I install engram in Claude Code?
Run claude mcp add engram -- npx -y @spectra-g/engram-adapter.
What does engram do?
It builds a graph from git history and tests, reports coupled files, and stores project notes. The agent queries it before writing code.
Which test frameworks does it support?
Vitest, Jest, Mocha, Playwright and Cypress for JS/TS; JUnit 4 and 5, Kotest and ScalaTest for the JVM; native Rust; Pytest and Unittest for Python; native Go.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →engram by other authors comes first.
