ivygrep MCP server

Turn coding tasks into bounded, branch-aware context. Search, indexing, and context generation run locally. Optional model profiles download pinned assets on first use.

Website · Architecture · Benchmarks · Contributing · Discussions

Search and build context

# Find code by intent
ig "where is refresh token rotated?"

# Build context from code and current changes
ig context "fix refresh-token races" --since main --budget 8000

Abridged output:

# ivygrep context
Budget: 7642 / 8000 estimated tokens
Coverage: 7 files | 2 primary | 1 definitions | 1 dependencies | 0 dependents | 2 callers | 0 references | 1 tests | 0 config | 0 docs
Candidates: 31 retrieved | 14 selected
## Evidence
### 1. src/auth/refresh.rs:118-166 [primary, definition]
Why: task anchor; changed implementation.
Signals: lexical, symbol, git change.

Search answers where. Context answers what an agent needs to change safely.

The context command combines task anchors with commits since the branch point, staged and dirty files, issue or trace paths, and indexed relationships. It returns one bounded Markdown pack with path, lines, role, reason, and retrieval signals. --since takes a branch or revision such as main, HEAD~3, or @{upstream} and requires a Git worktree; omit it for non-Git directories.

Install

# Homebrew on macOS or Linux
brew install bvolpato/tap/ivygrep

# Release installer on macOS or Linux
curl -fsSL https://raw.githubusercontent.com/bvolpato/ivygrep/main/install.sh | sh

# WinGet on Windows
winget install --id BrunoVolpato.ivygrep --exact

# Release installer on Windows
irm https://raw.githubusercontent.com/bvolpato/ivygrep/main/install.ps1 | iex

Installers select a compatible archive, verify its SHA-256 checksum, install ig, and report the selected backend. Apple Silicon uses Metal. NVIDIA Linux hosts use the Linux x8664 CUDA build when CUDA 13 and compute capability 8.0 or newer are available. Other systems use portable local inference. GPU builds only speed up transformer profiles (IVYGREPMODEL_PROFILE=code|code-hq|general); the default potion-code-16m-v2 profile runs on CPU. Run ig hardware to see detected hardware, compatibility limits, and the matching reinstall command.

Build from source on macOS or Linux:

git clone https://github.com/bvolpato/ivygrep.git && cd ivygrep
./build.sh
mkdir -p ~/.local/bin
install -m 0755 target/release/ig ~/.local/bin/ig

Search

Shortened. The full README is on GitHub.