
Mcp Codebase Index
This is a structural AST parser that builds a queryable index of your codebase and exposes it through 18 MCP tools. It handles Python (full AST), TypeScript/JS, Go, Rust, and C# (regex-based extraction), letting Claude find symbols, pull function source, trace dependencies, and search across files without reading everything into context. The server watches git for changes and reindexes incrementally in 1-2ms, plus it caches the index to disk so restarts are instant if nothing changed. Zero dependencies means it ships with Python stdlib only. Reach for this when you want Claude to navigate a large project efficiently or when you're hitting token limits from dumping whole files into prompts just to locate a single function.
- GitHub stars
- 56
- tools
- 18
- transport
- STDIO
- last updated
- Feb 17, 2026
Tools
18 toolsPublic tool metadata for what this MCP can expose to an agent.
get_project_summaryFile count, packages, top classes/functions
File count, packages, top classes/functions
No parameter schema in public metadata yet.
list_filesList indexed files with optional glob filter
List indexed files with optional glob filter
No parameter schema in public metadata yet.
get_structure_summaryStructure of a file or the whole project
Structure of a file or the whole project
No parameter schema in public metadata yet.
get_functionsList functions with name, lines, params
List functions with name, lines, params
No parameter schema in public metadata yet.
get_classesList classes with name, lines, methods, bases
List classes with name, lines, methods, bases
No parameter schema in public metadata yet.
get_importsList imports with module, names, line
List imports with module, names, line
No parameter schema in public metadata yet.
get_function_sourceFull source of a function/method
Full source of a function/method
No parameter schema in public metadata yet.
get_class_sourceFull source of a class
Full source of a class
No parameter schema in public metadata yet.
find_symbolFind where a symbol is defined (file, line, type)
Find where a symbol is defined (file, line, type)
No parameter schema in public metadata yet.
get_dependenciesWhat a symbol calls/uses
What a symbol calls/uses
No parameter schema in public metadata yet.
get_dependentsWhat calls/uses a symbol
What calls/uses a symbol
No parameter schema in public metadata yet.
get_change_impactDirect + transitive dependents
Direct + transitive dependents
No parameter schema in public metadata yet.
get_call_chainShortest dependency path (BFS)
Shortest dependency path (BFS)
No parameter schema in public metadata yet.
get_file_dependenciesFiles imported by a given file
Files imported by a given file
No parameter schema in public metadata yet.
get_file_dependentsFiles that import from a given file
Files that import from a given file
No parameter schema in public metadata yet.
search_codebaseRegex search across all files (max 100 results)
Regex search across all files (max 100 results)
No parameter schema in public metadata yet.
reindexForce full re-index (rarely needed — incremental updates happen automatically in git repos)
Force full re-index (rarely needed — incremental updates happen automatically in git repos)
No parameter schema in public metadata yet.
get_usage_statsSession efficiency stats: tool calls, characters returned vs total source, estimated token savings
Session efficiency stats: tool calls, characters returned vs total source, estimated token savings
No parameter schema in public metadata yet.
Sponsors
Readme
mcp-codebase-index
A structural codebase indexer with an MCP server for AI-assisted development. Zero runtime dependencies — uses Python's ast module for Python analysis and regex-based parsing for TypeScript/JS, Go, Rust, and C#. Requires Python 3.11+.
What It Does
Details
- Repository
- github.com/mikerecognex/mcp-codebase-index
- Category
- Search & Web Crawling
- Package
mcp-codebase-index- Transport
- STDIO
- Registry
- MCP registry, active