Mcp Codebase Index
Give your coding agent structural codebase queries instead of pasting whole files, cutting context size on large repos.
Overview
mcp-codebase-index is an MCP server for the Build phase that indexes repository structure and serves seventeen low-token query tools to coding agents.
What is this MCP server?
- 17 MCP query tools for structural codebase navigation
- Advertised ~87% token reduction versus raw file context
- Zero declared runtime dependencies for lighter installs
- PyPI package mcp-codebase-index v0.2.2 with stdio transport
- GitHub source: MikeRecognex/mcp-codebase-index
- 17 query tools
- 87% token reduction (vendor claim)
- Zero dependencies (vendor claim)
Community signal: 56 GitHub stars.
What problem does it solve?
Agents burn context and miss structure when they grep and paste whole files from large codebases.
Who is it for?
Solo builders on big or unfamiliar repos who want Claude Code or Cursor to navigate code without maxing the context window.
Skip if: Teams that only need one-off edits in tiny projects where reading a few files manually is faster than running an indexer.
What do I get? / Deliverables
Your agent queries a structural index and gets targeted answers with far less token overhead.
- Registered stdio MCP server exposing 17 structural query tools
- Indexed view of the target codebase for agent sessions
- Lower-token codebase answers during agent-driven build work
Recommended MCP Servers
Journey fit
Indexing and querying repo structure is core work while wiring agents and integrations during the build phase. Agent-tooling is where MCP servers that replace naive file dumps with structured indexes belong on the journey shelf.
How it compares
Structural codebase MCP indexer, not a semantic embedding search or documentation generator.
Common Questions / FAQ
Who is mcp-codebase-index for?
Indie developers and agent users who need fast, structural questions answered across a whole repository without shipping entire files into the prompt.
When should I use mcp-codebase-index?
Use it during build and refactor work when you need symbols, modules, or relationships and want roughly 87% less context than naive file reads.
How do I add mcp-codebase-index to my agent?
Install the PyPI package mcp-codebase-index, register the stdio MCP server in Claude Code or your client’s MCP config, and point it at your project root.