Navigator MCP server
ai.mentu/navigator·v1.0.2Read-only repo navigation and progressive disclosure; BM25 locator with registered evidence.
0 stars95 downloads/wk
Reviews
Write oneNobody has reviewed Navigator yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Navigator tools (8)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
locateProgressive disclosure entrypoint: fuse a ranked lexical leg and an exact leg into k=8 source ranges, each with path, line, heading-anchored range, a snippet of at most 240 characters, retriever attribution, and its reason. Read a range with read_range before making a claim.
navigatorPreferred entrypoint for agents. Auto-routes one repository question to a map, ranked query, frontmatter handles, symbol context, or Git change-impact report and returns compact source-backed evidence.
navigator_change_impactSpecialist tool: relate an explicit Git change range to tests, contracts, ticket references, and risk signals.
navigator_handlesSpecialist tool: discover typed docs and relationships from bounded YAML frontmatter. Results are routing pointers and require reading the source body before claims.
navigator_mapSpecialist tool: map repository structure, languages, contracts, manifests, and typed docs without reading secrets.
navigator_querySpecialist tool: find and rank source-backed repository evidence for a natural-language or exact query.
navigator_symbol_contextSpecialist tool: collect definitions, references, tests, docs, and config surrounding a known symbol.
read_rangeReturn the source lines a locate hit points at. Widening is ±20 lines per step and stops at heading boundaries; frontmatter comes back in its own field and is never inlined into the body slice.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan25 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 37 days ago12/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10
How Navigator compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,255 servers
- Tools
- 8
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 95
- more than 62% of 12,191 servers with a package
What its tools let an agent do: 8 read
Install Navigator in Claude Code, Cursor or VS Code
Runs npx -y mentu-navigator on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add navigator -- npx -y mentu-navigator
What the publisher says
From the Navigator repository's README, as published. We do not edit it. Read it on GitHub
mentu-navigator
Read-only, provenance-first repository navigation for humans and AI agents.
Point it at a repository and ask a question. It returns ranked file-and-line ranges to read, each carrying the reason it ranked, and it never writes to the repository it reads. It is built for coding agents that must orient in an unfamiliar codebase without pulling the whole thing into context, and for the people reviewing what those agents did.
mentu-navigator is the product name. mentu-nav is its short CLI.
Install
Requires Node.js 20 or newer.
npm install -g mentu-navigator # CLI: mentu-nav, MCP server: mentu-navigator-mcpTo run it without installing:
npx -p mentu-navigator mentu-nav "where is retry handled?"The package name and the command name differ, so npx mentu-navigator on its own cannot resolve a binary. Pass -p as above.
License: Apache-2.0. Telemetry is local-only JSONL under ~/.mentu/pd1/ (spec: docs/TELEMETRY-SPEC.md); disable with MENTUNAVTELEMETRY=off. Nothing ever leaves the machine.
Where it sits in Mentu
mentu-navigator is the retrieval surface. mentu-pdv validates the frontmatter schema this tool consumes and emits the demotion sets locate applies. The two are designed as a pair, and the schema is published as a spec (SPEC-frontmatter.md).
Why it exists
Search tools find matching text. A repository navigator also preserves the question's intent and returns the nearby contracts, tests, docs, Git lineage, and risk surfaces needed to act safely.
The first release is intentionally deterministic:
replace reading them;
- no embeddings;
- no background index;
- no writes to target repositories;
- on-demand, bounded frontmatter handles that route to documents but never
- bounded snippets with file-and-line provenance;
- known secret-bearing paths excluded before content reads.
One-command start
cd /path/to/repository
mentu-nav
mentu-nav "where is DEMO-274 implemented and tested?"Interactive terminals receive a concise human view. Pipes receive compact JSON; --json requests the full envelope. Agents should use --agent for a compact, token-efficient JSON contract:
mentu-nav --agent "where is DEMO-274 implemented and tested?"The front door auto-routes to map, query, handles, symbol, or impact. Their explicit commands remain available for scripts and advanced use.
For a docs-as-code network:
mentu-nav handles "catalog lineage"This returns metadata pointers, typed relationships, and diagnostics. Every pointer carries requiresHydration: true. query keeps these pointers separate from source-body evidence so a summary cannot silently become an answer.
Capabilities
Progressive disclosure: locate and read-range
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Navigator: common questions
- Is Navigator MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Navigator safety report
- How do I install Navigator?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Navigator need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Navigator maintained?
- The last commit was 38 days ago (2026-09-27). The latest release is v1.0.2.
- How does Navigator compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.