repo-index-mcp

Local codebase retrieval tool for coding agents. Phase 1 is a walking skeleton: index one git repo into SQLite, query chunks from the CLI, and expose retrieval over MCP stdio.

Install

pipx install .

For development:

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

Related MCP server: codemogger

Use

Index a repo:

repo-index index /path/to/git/repo

Query it:

repo-index query "where is request retry handled" -k 5

Show indexed repos:

repo-index status

Run the MCP server over stdio:

repo-index serve

Agent config example:

{
  "mcpServers": {
    "repo-index": {
      "command": "repo-index",
      "args": ["serve"]
    }
  }
}

Phase 1 limits

• One-repo indexing flow.

• Naive line-window chunks.

• Local deterministic hash embeddings, not quality-tuned semantic embeddings.

• SQLite storage implemented with Python cosine search, no ANN/vector extension yet.

• get_symbol is best-effort search until tree-sitter symbol extraction lands.

Data boundary

Default embedding is local and deterministic. Source code is not sent to external APIs.