code-nav-mcp

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/)

Reduce Claude Code token usage by 95-99% for code navigation tasks!

A generic MCP server for efficient code navigation across any repository (Linux kernel, libcamera, your projects, etc.) without reading full files.

# 1. Clone the repo
git clone https://github.com/Balki01/code-nav-mcp.git
cd code-nav-mcp

# 2. Run installer
./install.sh

# 3. Add to Claude Code .mcp.json
# See Installation section below

• Symbol Lookup: Find function/struct/macro definitions instantly (ctags-based)
• Cross-References: Find all usages of a symbol (ripgrep-based)
• Caller Analysis: See who calls a function
• Git Integration: Blame functions, show commit history
• Multi-Repo: Index and search multiple repos simultaneously
• Smart Grep: Structured grep output without full file reads

# Python MCP SDK
pip install mcp

# System tools (if not already installed)
sudo apt install universal-ctags ripgrep

chmod +x server.py

Option A: Project-level (Recommended)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "code-nav": {
      "command": "/absolute/path/to/code-nav-mcp/run_server.sh"
    }
  }
}

Option B: Global settings

Add to ~/.claude/settings.json - NOT RECOMMENDED, see MCP configuration docs

After adding the MCP server configuration, restart Claude Code to load the new server.

First, add and index the repos you want to navigate:

# Add Linux kernel
add_repo(name="linux", path="/home/ad