mikerecognex avatar

Mcp Codebase Index

mikerecognex/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 tools

Public 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

PyPI version CI Python 3.11+ License: AGPL-3.0 MCP Zero Dependencies

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


View the full README on GitHub

Details

Repository
github.com/mikerecognex/mcp-codebase-index
Category
Search & Web Crawling
Package
mcp-codebase-index
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1adamamer20 avatarAdamamer20 Paper Search Mcp Openaiadamamer20/paper-search-mcp-openaiSearch and download academic papers from arXiv, PubMed, bioRxiv, medRxiv, Google Scholar, Semantic…13stars
2zeropointrepo avatarTranscriptAPI: YouTube Transcript and Search MCPzeropointrepo/youtube-mcpTranscriptAPI.com: hosted YouTube transcripts, search, channels and playlists for AI agents13stars
3kylinmountain avatarWeb Fetch Mcpkylinmountain/web-fetch-mcpMCP server for web content fetching, summarizing, comparing, and extracting information8stars
4whw23 avatarSearXNG HTTP MCPwhw23/searxng_http_mcpSelf-contained SearXNG metasearch MCP server. One Docker image, 200+ engines, privacy-first.8stars
5trondhindenes avatarCode Indextrondhindenes/code-index-mcpFast local source code searching using Zoekt trigram-based indexing6stars
6mharnett avatarBing Adsmharnett/mcp-bing-adsMCP server for Microsoft Advertising (Bing Ads) — campaigns, keywords, and reports2stars