Memoria is an MCP server that analyzes git commit history to uncover hidden file dependencies and prevent code-breaking refactors by AI assistants. It detects implicit coupling between files by identifying which files frequently change together in commits, even when they lack direct import relationships. Key features of Memoria: - Git forensics analysis to map implicit file dependencies through co-change detection - Identifies files that evolve together in the codebase without explicit import links - Surfaces hidden dependencies to AI assistants before they suggest refactors - Works with existing git repositories to build dependency awareness

Memoria

The Memory Your AI Lacks.

An MCP server that prevents your AI from breaking code by revealing hidden file dependencies through git forensics.

[](https://www.npmjs.com/package/@byronwade/memoria) [](https://opensource.org/licenses/MIT) [](https://www.typescriptlang.org/) [](https://modelcontextprotocol.io) [](https://twitter.com/byron_c_wade)

---

⚡ Quick Install

One-Click Install (Smithery)

Click the badge above to install Memoria with one click via Smithery.

Quick Copy-Paste Config

Add this to your MCP config file (works with Claude, Cursor, Windsurf, Cline):

{
  "mcpServers": {
    "memoria": {
      "command": "npx",
      "args": ["-y", "@byronwade/memoria"]
    }
  }
}

Terminal One-Liners

| Tool | Command | |------|---------| | Claude Code | claude mcp add memoria -- npx -y @byronwade/memoria | | Claude Desktop | npx @anthropic/claude-code mcp add memoria -- npx -y @byronwade/memoria | | Cursor | mkdir -p .cursor && echo '{"mcpServers":{"memoria":{"command":"npx","args":["-y","@byronwade/memoria"]}}}' > .cursor/mcp.json | | npm global | npm install -g @byronwade/memoria |

🪟 Windows PowerShell Install

# Claude Desktop
$config = "$env:APPDATA\Claude\claude_desktop_config.json"
$json = if(Test-Path $config){Get-Content $config | ConvertFrom-Json}else{@{}}
$json.mcpServers = @{memoria=@{command="npx";args=@("-y","@byronwade/memoria")}}
$json | ConvertTo-Json -Depth 10 | Set-Content $config

🍎 macOS Manual Install

# Claude Desktop (requires jq: brew install jq)
echo '{"mcpServers":{"memoria":{"command":"npx","args":["-y","@byronwade/memoria"]}}}' | \
  jq -s '.[0] * .[1]' ~/Library/Application\ Support/Claude/claude_desktop_config.json - > tmp.json && \
  mv tmp.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

Then restart your AI tool. That's it!

---

Why Memoria?

You ask your AI to refactor a file. It does a perfect job. You run your app. It crashes.

Why? Some other file depended on the old implementation - but there's no import between them, so the AI didn't know.

Memoria fixes this. It analyzes git history to find files that change together, even without direct imports.

Without Memoria:                        With Memoria:
─────────────────                       ─────────────
You: "Update route.ts"                  You: "Update route.ts"
AI: "Done!" ✅                           Memoria: "⚠️ 85% coupled with billing.tsx"
Result: 💥 CRASH                         AI: "I'll update both files"
                                        Result: ✅ Works

---

Private & Local

Memoria runs 100% on your machine.

Your code never leaves your computer.

---

Installation

Choose your AI tool:

| Tool | One-Liner | Config File | |------|-----------|-------------| | | npx @anthropic/claude-code mcp add memoria -- npx -y @byronwade/memoria | See below | | | claude mcp add memoria -- npx -y @byronwade/memoria | Automatic | | | mkdir -p .cursor && echo '{"mcpServers":{"memoria":{"command":"npx","args":["-y","@byronwade/memoria"]}}}' > .cursor/mcp.json | .cursor/mcp.json | | | Manual config | ~/.codeium/windsurf/mcp_config.json | | | Manual config | ~/.continue/config.json | | | Settings UI | Cline MCP Settings |

---

📦 Claude Desktop

Config location: