Yes, Code Index is free to use.

How do I install Code Index?

Code Index is a local plugin. Install it using PyPI package: mcp-code-index and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Code Index need?

Code Index requires the following credentials or environment variables: VOYAGE_API_KEY, CODE_INDEX_EMBEDDER, CODE_INDEX_EMBED_MODEL, CODE_INDEX_EMBED_DIM, CODE_INDEX_DB, OLLAMA_URL. You can find setup instructions on the server detail page.

What AI apps work with Code Index?

Code Index uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Code Index MCP Server

by Achreftlili

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

SQLite-backed hybrid (vector + FTS) code search index for Claude Code over MCP.

About

SQLite-backed hybrid (vector + FTS) code search index for Claude Code over MCP.

Security Report

4.2

Use Caution4.2High Risk

This is a well-structured MCP server for code indexing with appropriate security controls. The codebase is clean with proper input validation, safe database usage, and no credential handling issues. Permissions align with its purpose as a developer tool. Minor quality improvements around error handling specificity and logging would strengthen it further, but no critical vulnerabilities were identified. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.

4 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Voyage embeddings API key. Required when CODE_INDEX_EMBEDDER is unset or set to 'voyage' (the default backend).Required

Environment variable: VOYAGE_API_KEY

Embedder backend: 'voyage' (default) or 'ollama'. Set to 'ollama' to use a local Ollama server instead of Voyage.Optional

Environment variable: CODE_INDEX_EMBEDDER

Embedding model name. Defaults to 'voyage-code-3' for Voyage. Must match the embedder's available models.Optional

Environment variable: CODE_INDEX_EMBED_MODEL

Embedding dimension. Defaults to 1024 (matches voyage-code-3). Must match the model's output dim.Optional

Environment variable: CODE_INDEX_EMBED_DIM

Path to the SQLite index database. Defaults to .claude/index.db relative to the working directory.Optional

Environment variable: CODE_INDEX_DB

Ollama server URL when CODE_INDEX_EMBEDDER=ollama. Defaults to http://localhost:11434.Optional

Environment variable: OLLAMA_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-achreftlili-code-index": {
      "env": {
        "OLLAMA_URL": "your-ollama-url-here",
        "CODE_INDEX_DB": "your-code-index-db-here",
        "VOYAGE_API_KEY": "your-voyage-api-key-here",
        "CODE_INDEX_EMBEDDER": "your-code-index-embedder-here",
        "CODE_INDEX_EMBED_DIM": "your-code-index-embed-dim-here",
        "CODE_INDEX_EMBED_MODEL": "your-code-index-embed-model-here"
      },
      "args": [
        "mcp-code-index"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

code-index

A SQLite-backed code index for Claude Code, exposed via MCP. Replaces exploratory Read/Grep/Glob calls with targeted retrieval.

What it does

Parses your repo with tree-sitter (Python, TypeScript/JavaScript, Go, Rust).
Chunks per symbol; expands identifiers (getUserAuthToken → get user auth token).
Embeds with Voyage voyage-code-3 (default) or local Ollama.
Stores symbols, chunks, vectors, and call/import edges in .claude/index.db.
Serves retrieval over MCP — 8 retrieval tools + 1 admin tool (see below).
Auto-updates via a Claude Code PostToolUse hook and an optional file watcher.

Tools

Tool	Purpose
`init`	Build or refresh the project's index. Incremental by default; `force=true` rebuilds from scratch.
`code_search`	Hybrid (vector + FTS) search for conceptual queries (e.g., "auth flow", "where do we parse JSON").
`symbol_lookup`	Exact-name lookup of functions / classes / methods / types. Prefer over `code_search` for identifiers.
`file_outline`	Symbols (with signatures) in a file, in source order. Use instead of `Read` when you only need shape.
`get_symbol_body`	Full chunk for a `symbol_id` returned by `symbol_lookup` or `code_search`.
`callers`	Symbols that CALL the given symbol. `depth` (1-5) expands transitively.
`callees`	Symbols that the given symbol CALLS. `depth` (1-5) expands transitively.
`dependents`	Files that import the given file.
`dependencies`	Files that the given file imports.

All tools return bounded JSON; large bodies use get_symbol_body rather than inlining whole files.

Requirements

Python with loadable SQLite extension support (required by sqlite-vec). Python 3.13 has this enabled by default. For 3.10–3.12, use either:

the python.org installer, or
pyenv: PYTHON_CONFIGURE_OPTS=--enable-loadable-sqlite-extensions pyenv install 3.12.x

Install

In Claude Code (primary)

# 1. Set your embedder API key (Voyage default; for local Ollama see Configuration)
export VOYAGE_API_KEY=...

# 2. Register the MCP server. uvx clones, builds, and runs — no global install.
claude mcp add code-index -- uvx --from git+https://github.com/achreftlili/code-index code-index-mcp

That's it. Open Claude Code in your repo and ask:

"Build the code index for this repo."

Claude calls the init MCP tool, which writes .claude/index.db. Subsequent prompts can use code_search, symbol_lookup, callers, etc. — see Tools above for the full surface.

Or, with a permanent install

pip install mcp-code-index
claude mcp add code-index -- code-index-mcp

Optional: keep the index live as you edit

Without the hook below, the index drifts when files change outside the agent (mv, git checkout, IDE saves) until you call init again. With it, every Edit / Write / MultiEdit Claude performs triggers an incremental reindex of the touched file:

git clone https://github.com/achreftlili/code-index ~/code-index
~/code-index/scripts/install-hook.sh /path/to/your/repo   # idempotent

In other MCP-compatible agents

The server speaks standard MCP over stdio, so any client that supports MCP servers works (Cursor, Continue, Cody, Zed, etc.). Configure the client to launch code-index-mcp (after pip install) or the uvx --from git+… command above. Once connected, call the init tool from inside the client to bootstrap the index.

From source (development)

git clone https://github.com/achreftlili/code-index
cd code-index
pip install -e .
code-index init        # CLI alternative to the `init` MCP tool
code-index-mcp         # starts the MCP server on stdio (for manual wiring)

Configuration

Environment variables:

Var	Default	Notes
`CODE_INDEX_DB`	`.claude/index.db`	SQLite path.
`CODE_INDEX_EMBEDDER`	`voyage`	`voyage` or `ollama`.
`CODE_INDEX_EMBED_MODEL`	`voyage-code-3`	Model name.
`CODE_INDEX_EMBED_DIM`	`1024`	Must match the model.
`VOYAGE_API_KEY`	—	Required when `CODE_INDEX_EMBEDDER=voyage`.
`OLLAMA_URL`	`http://localhost:11434`	Ollama server.

Layout

src/code_index/
  db.py           SQLite schema, connection, sqlite-vec loading
  parser.py       Tree-sitter wrapper, symbol + edge extraction
  chunker.py      Per-symbol chunks, identifier expansion
  embedder.py     Voyage / Ollama backends
  indexer.py      Pipeline: walk → parse → chunk → embed → write
  retriever.py    Hybrid search (vector + FTS5) with RRF
  watcher.py      File watcher (watchdog)
  mcp_server.py   8 MCP tools
  cli.py          init / reindex / watch / stats

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Code Index MCP Server

About

Security Report

Findings (12)Action required

Permissions Required

What You'll Need

How to Install

Documentation

code-index

What it does

Tools

Requirements

Install

In Claude Code (primary)

Or, with a permanent install

Optional: keep the index live as you edit

In other MCP-compatible agents

From source (development)

Configuration

Layout

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

Google Workspace MCP