Code-Index-MCP

Give your AI coding assistant instant, precise search across your whole codebase — so it finds the exact code it needs in milliseconds instead of burning time and tokens reading whole files.

Code-Index-MCP is a fast,local-firstsearch index for your code. It plugs into Claude Code and other AI assistants (through the Model Context Protocol, "MCP") and lets them look up any symbol or search any text in your repository almost instantly — without your code ever leaving your machine.

New to Code-Index-MCP?Start with theGetting Started Guide.

Version: 1.4.0 (repo-owned prepared surface; unpublished as of July 10, 2026)Python distribution:index-it-mcpContainer image:ghcr.io/consiliency/code-index-mcpPrimary surface: MCP tools (search_code,symbol_lookup) via the STDIO runner when repository readiness isreadySecondary surface: FastAPI admin REST gateway for diagnostics and scripting — see "Admin REST Interface (secondary)" belowCore features: local indexing, symbol/text search, registry-based language coverage; seedocs/SUPPORT_MATRIX.mdOptional features: semantic search (requires Voyage AI or a local vLLM endpoint), GitHub Artifacts index syncPerformance: sub-100ms symbol lookup and sub-500ms search on indexed repos (benchmarked on this codebase; results vary by repo size and language mix)GA decision: seedocs/validation/ga-final-decision.md; the current product decision isship GA, while install-surface claims remain bounded bydocs/status/public-package-identity.md.GA readiness contract: seedocs/validation/ga-readiness-checklist.mdfor the frozen release boundary, support-tier labels, evidence ownership, and rollback expectations that apply before dispatch.Release dispatch: the historical governance record names this boundaryGADISP; the current workflow implements it as a separatepublishmode restricted to protectedmain.Repository model: one server can serve many unrelated repositories, with one registered worktree per git common directory. Only the tracked/default branch is indexed automatically. Indexed MCP results are authoritative only when readiness isready; unavailable indexes returnindex_unavailablewithsafe_fallback: "native_search".

- 🚀 Local-First Architecture: All indexing happens locally for speed and privacy
- 📂 Local Index Storage: All indexes stored at.indexes/(relative to MCP server)
- 🔌 Plugin-Based Design: Easily extensible with language-specific plugins
- 🔍 Language support: Tiered language/runtime support is documented in[docs/SUPPORT_MATRIX.md
- ⚡ Real-Time Updates: File system monitoring for instant index updates
- 🧠 Semantic Search: AI-powered code search with Voyage AI embeddings
- 📊 Rich Code Intelligence: Symbol resolution, type inference, dependency tracking
- 🚀 Enhanced Performance: Sub-100ms queries with timeout protection and BM25 bypass
- 🔄 Git Synchronization: Automatic index updates tracking repository changes
- 📦 Portable Index Management: Zero-cost index sharing via GitHub Artifacts
- 🔄 Automatic Index Sync: Pull indexes on clone, push on changes
- 🎯 Smart Result Reranking: Multi-strategy reranking for improved relevance
- 🎯 Query-Intent Routing: Symbol-pattern queries (class Foo,def bar, CamelCase) bypass BM25 and hit the symbols table directly for sub-5ms lookups
- 🔒 Security-Aware Export: Automatic filtering of sensitive files from shared indexes
- 🔍 Hybrid Search: BM25 + semantic search with configurable fusion
- 🔐 Index Everything Locally: Search .env files and secrets on your machine
- 🚫 Smart Filtering on Share: .gitignore and .mcp-index-ignore patterns applied only during export
- 🌐 Multi-Language Indexing: Index entire repositories with mixed languages

The Code-Index-MCP follows a modular, plugin-based architecture designed for extensibility and performance:

- Developer interacts with Claude Code or other LLMs
- MCP protocol provides standardized tool interface
- Local-first processing with optional cloud features
- Performance SLAs: <100ms symbol lookup, <500ms search

┌─────────────────┐ ┌──────────────┐ ┌─────────────┐ │ API Gateway │────▶│ Dispatcher │────▶│ Plugins │ │ (FastAPI) │ │ │ │ (Language) │ └─────────────────┘ └──────────────┘ └─────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────┐ ┌──────────────┐ ┌─────────────┐ │ Local Index │ │ File Watcher │ │ Embedding │ │ (SQLite+FTS5) │ │ (Watchdog) │ │ Service │ └─────────────────┘ └──────────────┘ └─────────────┘

- Gateway Controller: RESTful API endpoints
- Dispatcher Core: Plugin routing and lifecycle
- Plugin Base: Standard interface for all plugins
- Language Plugins: Specialized parsers and analyzers
- Index Manager: SQLite with FTS5 for fast searches
- Watcher Service: Real-time file monitoring

Code-Index-MCP implements defense-in-depth security hardening (Phase 15):

…