mcp-codebase-index

Overview

mcp-codebase-index is a structural codebase indexer that parses source files into metadata and exposes 18 query tools via MCP. It supports Python, TypeScript/JS, Go, Rust, and C# files with automatic incremental re-indexing in git repositories. The server uses persistent disk caching to eliminate cold-start penalties and can handle large codebases efficiently (tested on CPython with 1.1M lines).

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• get_project_summary

  Get file count, packages, top classes/functions

  Try:Show me the project overviewTry:What are the main components of this codebase?
• list_files

  List indexed files with optional glob filter

  Try:List all Python filesTry:Show me all files in the src directory
• get_structure_summary

  Get structure of a file or the whole project

  Try:What's the structure of main.py?Try:Show me the overall project structure
• get_functions

  List functions with name, lines, params

  Try:List all functionsTry:What functions are in utils.py?
• get_classes

  List classes with name, lines, methods, bases

  Try:Show me all classesTry:What classes exist in models.py?
• get_imports

  List imports with module, names, line

  Try:What modules are imported in main.py?Try:List all imports in the project
• get_function_source

  Get full source of a function/method

  Try:Show me the source of process_dataTry:Get the implementation of calculate
• get_class_source

  Get full source of a class

  Try:Show me the User class implementationTry:Get the source code for Database
• find_symbol

  Find where a symbol is defined (file, line, type)

  Try:Where is authenticate defined?Try:Find the location of logger
• get_dependencies

  Get what a symbol calls/uses

  Try:What does process_data depend on?Try:Show dependencies of main
• get_dependents

  Get what calls/uses a symbol

  Try:What uses authenticate?Try:Show all callers of logger
• get_change_impact

  Get direct + transitive dependents of a symbol

  Try:What will break if I change User?Try:Show impact of modifying logger

Comparable tools

Installation

pip install "mcp-codebase-index[mcp]"

{
  "mcpServers": {
    "codebase-index": {
      "command": "mcp-codebase-index",
      "env": {
        "PROJECT_ROOT": "/path/to/project"
      }
    }
  }
}

FAQ

How does it handle large codebases efficiently?

It uses persistent disk caching and incremental updates based on git diff, only re-parsing changed files (~1-2ms). On CPython (1.1M lines), index build takes 56s initially but loads from cache in under 1s on subsequent starts.

Which languages are supported?

Python (AST parsing), TypeScript/JS, Go, Rust, C# (regex-based), and Markdown/Text files. Other files only provide line counts.

On Hacker News

Recent discussion from the developer community.

• Show HN: MCP Codebase Index – 87% fewer tokens when AI navigates your codebase▲ 1
  Story by localforthewin · 2026-02-17

Compare mcp-codebase-index with