Code Index
Give Claude Code fast hybrid semantic and keyword search across your repo without stuffing whole trees into context.
Overview
Code Index is a MCP server for the Build phase that serves hybrid vector and full-text search over your repository from a local SQLite index.
What is this MCP server?
- SQLite-backed index with hybrid vector plus FTS retrieval
- Local jina-embeddings-v2-base-code via sentence-transformers (768-dim default)
- Configurable CODE_INDEX_DB path (default .claude/index.db)
- stdio MCP transport on PyPI package mcp-code-index v1.0.6
- Embedder env knobs for model id and dimension when you need a compatible swap
- Server version 1.0.6
- Default embedding dimension 768 (jina-embeddings-v2-base-code)
- Default database path .claude/index.db
What problem does it solve?
Agents lose time and context window re-scanning huge repos because keyword search misses intent and pasting files is expensive.
Who is it for?
Solo builders on Claude Code who want local, private semantic code search tied into MCP.
Skip if: Teams that need hosted multi-repo search with ACLs or zero local ML dependencies.
What do I get? / Deliverables
After install, Claude Code can query a persistent local code index for relevant snippets instead of blind file walks.
- Queryable local SQLite hybrid code index for the workspace
- MCP tools that return ranked code chunks from vector plus FTS
- Configurable embedding and database paths via environment variables
Recommended MCP Servers
Journey fit
Code-indexing MCP is canonical on the build shelf because solo builders add it while wiring agent tooling into day-to-day implementation. agent-tooling is where MCP servers that extend Claude Code’s workspace capabilities belong in the journey.
How it compares
MCP search integration, not a one-off Claude skill or a hosted codebase SaaS.
Common Questions / FAQ
Who is Code Index for?
It is for Claude Code users who want a local SQLite hybrid index so agents retrieve code by meaning and keywords without external search APIs.
When should I use Code Index?
Use it while building or debugging when the repo is too large for repeated full-file reads and you want durable indexed search across sessions.
How do I add Code Index to my agent?
Install the mcp-code-index PyPI package, configure stdio MCP in Claude Code, and set CODE_INDEX_DB and optional CODE_INDEX_EMBED_* variables to match your workspace.