Skip to main content
Glama
code_nav MCP

code_nav MCP

by ARQAWA

code_nav MCP

AI-native deterministic code navigation MCP server for Codex / CodeCLI.

code_nav gives coding agents compact, structured repo context without making them dump files into chat. It works in any git repo by detecting the repo root and using git-visible files.

There is no semantic search, no embeddings, no vector database, no graph index, no Qdrant, no CocoIndex, and no Zoekt.

Repository:

https://github.com/ARQAWA/code-nav-mcp

Install Prompt

Use INSTALL_AGENT_PROMPT.md with Codex / CodeCLI on the target machine.

The prompt installs one shared user-level code_nav MCP:

$HOME/.local/share/code-nav-mcp/app
$HOME/.local/bin/code-nav-mcp

It also installs/checks Probe, ast-grep, ripgrep, and RTK, configures Codex MCP globally, installs Code Navigation Rules, and verifies the MCP tools.

Related MCP server: Satori

Tools

Tool

Purpose

code_nav.health

Check repo detection and dependency health.

code_nav.search

Main deterministic code discovery workflow.

code_nav.find_file

File/path discovery.

code_nav.exact_search

Ranked exact text search, not proof.

code_nav.extract_context

Compact code context extraction.

code_nav.structural_search

AST search with ast-grep.

code_nav.exact_audit

Exhaustive proof using raw rg/git grep.

code_nav.coverage

File coverage and no-semantic-index status.

Local Development

npm install
npm run build
npm test
npm run doctor
npm run self-test

Run the MCP server locally:

node dist/cli.js mcp

Optional Repo Config

No per-repo config is required. Rare overrides can use .code-navrc.json:

{
  "max_file_bytes": 2097152,
  "extra_exclude": [],
  "extra_include": [],
  "markdown": "normal",
  "result_limit": 12
}

Available Tools

8 tools
code_nav.coverageA
Read-only

Show git-visible file coverage; no semantic index exists.

Inputs: no named parameters.

code_nav.exact_auditC
Read-only

Exhaustive exact audit using raw rg or git grep.

Inputs: pattern (required), scope, fixed, case_sensitive, +1 more.

code_nav.extract_contextC
Read-only

Extract compact code context with Probe or fallback ranges.

Inputs: targets (required), query, max_tokens.

code_nav.find_fileA
Read-only

Find repo-relative files with fff or git-visible fallback.

Inputs: query (required), scope, limit.

code_nav.healthA
Read-only

Check repo detection and code_nav dependency health.

Inputs: no named parameters.

code_nav.searchD
Read-only

Main deterministic code navigation workflow.

Inputs: task (required), memory_context, scope, limit, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a distinct purpose: coverage, exact audit, exact search, context extraction, file finding, health check, main search workflow, and structural search. No significant overlap; an agent can easily differentiate them.

    Naming Consistency4/5

    All tools follow a consistent prefix 'code_nav.' and use lowercase with underscores. However, the action part varies between nouns (e.g., 'coverage', 'health') and verb_noun patterns (e.g., 'find_file', 'extract_context'), showing minor inconsistency.

    Tool Count5/5

    With 8 tools, the set is well-scoped for code navigation. Each tool serves a clear function, and the count feels appropriate without being excessive or too sparse.

    Completeness4/5

    The tools cover a broad range of code navigation tasks: text search, structural search, file finding, coverage, and context extraction. Minor gaps exist like symbol search or definition lookup, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Local MCP server that provides semantic search (RAG) over code repositories, enabling AI clients like Claude and Gemini to access project context without manual re-upload.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Agent-safe code retrieval MCP server that indexes repositories and provides semantic search, file navigation, call graph analysis, and bounded file reading tools for coding agents.
      3
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for local codebase analysis, enabling semantic code search, impact analysis, and pack-scoped retrieval with cited file:line results.
      85 PyPI
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Local-first code intelligence MCP server that enables coding agents to search code, inspect structure, read exact ranges, and explore Git history with explicit token budgets.
      171
      Apache 2.0