Codebase Index MCP Server

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+. Its 18 documented tools cover summary, source, dependencies, dependents. It runs locally over stdio via the published package.

People connecting coding agent tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-02-28 · ★ 62 · #110 OF 194 MAINTAINED CODING AGENT · VERIFIED 2026-08-25

AGPL-3.0 · Python servers · how we verify → /methodology

01 · Install Codebase Index

before you install - you'll need

PROJECT_ROOT is optional or environment-specific per the README.

Claude Code

claude mcp add mikerecognex-mcp-codebase-index -- uvx mcp-codebase-index

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mikerecognex-mcp-codebase-index": {
      "command": "uvx",
      "args": [
        "mcp-codebase-index"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license AGPL-3.0 - declared in the repository

pypi package mcp-codebase-index - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.MikeRecognex is GitHub-verified and matches the repo owner

03 · What Codebase Index can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list indexed files with optional glob filter, list functions with name, lines, params, list classes with name, lines, methods, bases, and list imports with module, names, line.

Capability map

Tools grouped from the project's README - what Codebase Index lets an agent do.

read & search

17 tools - e.g. File count, packages, top classes/functions; List indexed files with optional glob filter; Structure of a file or the whole project

get_project_summary · list_files · get_structure_summary · get_functions · get_classes · get_imports…

Reindex

1 tool - e.g. Force full re-index (rarely needed - incremental updates happen automatically in git repos)

reindex

Limitations (from the README)

By default, AI assistants will ignore the indexed tools and fall back to reading entire files with Glob/Grep/Read. Soft language like "prefer" gets rationalized away. Add this to your project's CLAUDE.md (or equivalent instructions file) with mandatory language: The word "prefer" is too weak - models treat it as a suggestion and default to familiar tools. Mandatory language with explicit fallback criteria is what act

Latest releases

v0.7.0 · 2026-02-25

What's New · find_symbol now returns signature and source preview - eliminates the need for a follow-up get_function_source call. · For functions/methods: · end_line, signature (e.g. def bulk_create(objs, batch_size…

v0.5.0 · 2026-02-24

What's New · Persistent disk cache - The index is now saved to .codebase-index-cache.pkl after every build. On subsequent server starts: · Exact cache hit: If the cached git ref matches HEAD, the index loads instantly…

v0.4.5 · 2026-02-20

Changes since v0.4.2 · v0.4.5 · Fix get_usage_stats: use per-tool cost multipliers instead of assuming every query reads the entire codebase · - e.g. find_symbol estimates 5% of codebase, get_change_impact estimates…

04 · Who maintains Codebase Index

mcp-codebase-index is maintained by mikerecognex. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/mikerecognex/mcp-codebase-index
category: coding agent - ranked #110 of 194 actively-maintained coding agent servers as of 2026-08-25.
registry: io.github.MikeRecognex/mcp-codebase-index (active, first published 2026-02-17)
packages: pypi:mcp-codebase-index

06 · Codebase Index FAQ

Is Codebase Index still maintained?

Yes - as of 2026-08-25, its last commit was 2026-02-28. We re-verify nightly.

What can Codebase Index do?

How do I install Codebase Index?

Run `uvx mcp-codebase-index`. The README documents one environment variable (PROJECT_ROOT) to set first. PROJECT_ROOT is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Codebase Index run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Codebase Index

Alternatives to Codebase Index

Maintained coding agent servers if Codebase Index isn't the fit.

Pairs well with

Servers that cover what Codebase Index doesn't - only shown when the pairing reason fits the companion.

More coding agent MCP servers · Codexa · Madar · Commit Lore · Codeix · Lean Token

More Python MCP servers · Mimer MCP · Tooluniverse · Agenticorg · Paper Banana CN · Terminal MCP · see all