MCP Codebase Index MCP Server

A structural codebase indexer with an [MCP](https://modelcontextprotocol.io) server for AI-assisted development. Zero runtime dependencies — uses

Remote serverstreamable-httpPython

What is the MCP Codebase Index MCP Server?

A structural codebase indexer with an MCP server for AI-assisted development. Zero runtime dependencies — uses Python's ast

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_project_summaryFile count, packages, top classes/functions
list_filesList indexed files with optional glob filter
get_structure_summaryStructure of a file or the whole project
get_functionsList functions with name, lines, params
get_classesList classes with name, lines, methods, bases
get_importsList imports with module, names, line
get_function_sourceFull source of a function/method
get_class_sourceFull source of a class
find_symbolFind where a symbol is defined (file, line, type)
get_dependenciesWhat a symbol calls/uses
get_dependentsWhat calls/uses a symbol
get_change_impactDirect + transitive dependents
get_call_chainShortest dependency path (BFS)
get_file_dependenciesFiles imported by a given file
get_file_dependentsFiles that import from a given file
search_codebaseRegex search across all files (max 100 results)
reindexForce full re-index (rarely needed — incremental updates happen automatically in git repos)
get_usage_statsSession efficiency stats: tool calls, characters returned vs total source, estimated token savings

How to install the MCP Codebase Index MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PROJECT_ROOTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use MCP Codebase Index to get project summary.”
  • “Use MCP Codebase Index to list files.”
  • “Use MCP Codebase Index to get structure summary.”

Frequently asked questions

A structural codebase indexer with an [MCP](https://modelcontextprotocol.io) server for AI-assisted development. Zero runtime dependencies — uses Python's `ast` Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.