navigator — Claude Code MCP server: repository navigation
Finds relevant files and line ranges in a repository, with reasons for their ranking. Useful when an agent needs evidence for a question without loading the whole project into context.
claude mcp add navigator -- npx -y mentu-navigatorWhat navigator does
navigator helps an agent explore a repository without changing its files. Its locate command ranks text matches with BM25 and returns paths, line ranges, snippets, and ranking reasons. read-range then reads a selected section bounded by headings.
The server can also map repository contents, find symbol definitions, and assess possible effects of a Git range using tests and contracts. For documentation with frontmatter, handles returns pointers and relationships that must be hydrated separately. Ranking was evaluated on documentation rather than source code, so that evidence does not establish search quality on code.
Node.js 20 or newer is required. The server can run through npx; the Claude Code setup command is below. It only reads the repository and does not modify its files.
What it helps with
- find files and lines relevant to a project question
- select a documentation range without loading the whole file
- trace a symbol’s definitions and references
- check which tests and contracts a Git change may affect
Example prompts for the agent
- Find where this repository handles request retries and show the relevant line ranges.
- Map the repository and find the definitions of
RetryPolicy. - Check which tests and contracts may be affected by the current Git range.
How to install navigator
Platform CLI
claude mcp add navigator -- npx -y mentu-navigatorPlatform CLI
codex mcp add navigator -- npx -y mentu-navigatorConfig file
{
"mcpServers": {
"navigator": {
"command": "npx",
"args": [
"-y",
"mentu-navigator"
]
}
}
}Config file
{
"servers": {
"navigator": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mentu-navigator"
]
}
}
}Platform CLI
gemini mcp add navigator npx -y mentu-navigatorStep 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 navigator
How do I install navigator in Claude Code?
Run claude mcp add navigator -- npx -y mentu-navigator. Node.js 20 or newer is required.
What does navigator do?
It finds relevant repository files and line ranges, explains why results ranked, and lets you read a selected section. It does not modify repository files.
What does navigator require?
It requires Node.js 20 or newer. locate uses BM25; its ranking was evaluated on documentation, not source code.
