Mcp Codebase Index
by MikeRecognexcommunityv0.2.2
53
7
This MCP server indexes codebases by parsing source files into structural metadata and exposes 18 query tools via the Model Context Protocol for efficient navigation of codebases.
From the registry: Structural codebase indexer with 17 query tools. 87% token reduction. Zero dependencies.
Install & configure
Prerequisites
- required
- requiredInstall packageInstall mcp-codebase-index with MCP extras
$ pip install "mcp-codebase-index[mcp]"
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-codebase-index` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Python 3.11+** — Required runtime (https://www.python.org/downloads/)
- **Install package** — Install mcp-codebase-index with MCP extras Run: `pip install "mcp-codebase-index[mcp]"`
Canonical MCP server config (stdio transport):
- command: `mcp-codebase-index`
- args: []
- required environment variables:
- `PROJECT_ROOT`: Directory to index (example: `/path/to/project`)
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Tools (18)
get_project_summary
File count, packages, top classes/functions
list_files
List indexed files with optional glob filter
get_structure_summary
Structure of a file or the whole project
get_functions
List functions with name, lines, params
get_classes
List classes with name, lines, methods, bases
get_imports
List imports with module, names, line
get_function_source
Full source of a function/method
get_class_source
Full source of a class
find_symbol
Find where a symbol is defined (file, line, type)
get_dependencies
What a symbol calls/uses
get_dependents
What calls/uses a symbol
get_change_impact
Direct + transitive dependents
get_call_chain
Shortest dependency path (BFS)
get_file_dependencies
Files imported by a given file
Environment variables
PROJECT_ROOTrequiredSpecifies which directory to index.Prerequisites
- • Python 3.11+
- • python3
Packages
mcp-codebase-index
pypiv0.2.2transport: stdio
Details
- Language
- Python
- License
- AGPL-3.0
- Released
- Feb 17, 2026
- Last commit
- Feb 28, 2026
- Registry name
- io.github.MikeRecognex/mcp-codebase-index