MIMRY MCP server

MIMRY

<!-- mcp-name: io.github.jbacalso24/mimry -->

Local repo memory for coding agents. Ranked files, context packs, a code relationship graph, and feedback-tuned search, built from your own codebase.

Website · Install · Quickstart · For AI agents · MCP setup · Commands · Development

What is MIMRY?

MIMRY is a local command-line tool and MCP server that gives AI coding agents a memory of a code repository. It indexes a repo once, keeps the index fresh incrementally, and answers "which files matter for this task?" with a ranked, evidence-backed list and a written context pack.

No code is uploaded, there are no remote embeddings, and there is no telemetry.

• Who it is for: anyone using an AI coding agent (Claude Code, Codex, Copilot CLI, Gemini CLI, Cursor-style tools, and others) on a real codebase.
• The problem it solves: agents start every task cold. They grep blindly, reread the same files, miss the file that actually matters, and burn tokens and time doing it.
• What it does instead: one command, mimry preflight "", returns the files to read first, how they connect, what to verify with, and a context pack the agent reads before touching code.
• How it works: it parses source files into symbols and a relationship graph (imports, calls, definitions, inheritance, references), combines that with full-text and local semantic search, and learns from feedback about which files agents actually used.
• Where it runs: entirely on your machine.

It narrows where to look; source files, tests, and build output remain the final truth.

• What it is not: it is not a source of truth, a code generator, or an LLM.

Install

MIMRY is a Python package on PyPI and needs Python 3.11 or newer. It works on Windows, Linux, and macOS.

uv tool install mimry

pipx install mimry and pip install mimry also work. The install provides two commands: mimry (the CLI) and mimry-mcp (the MCP server for agents).

Check it:

mimry --help

Upgrade later with uv tool upgrade mimry.

Quickstart

Run these inside the project you want an agent to work on:

cd /path/to/your/project
mimry init
mimry index
mimry preflight "fix the login redirect bug"

preflight answers like this:

✓ Context ready for "fix the login redirect bug"
  Index is up to date (3,105 files, indexed just now)
  Context pack: .mimry/mimry-out/context/latest.md

Start with
   1  src/auth/session.py
      name matches · path matches
   2  src/app/login/page.tsx
      name matches
   3  tests/test_auth.py
      path matches

Next: read .mimry/mimry-out/context/latest.md before opening files.

Shortened. The full README is on GitHub.