Code Index MCP Server

Name: Code Index MCP Server
Author: io.github.achreftlili

io.github.achreftlili/code-index

Repository Registry

What is the Code Index MCP server?

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

How to install Code Index

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CODE_INDEX_EMBEDDER
Embedder backend. Only 'jina' (local jina-embeddings-v2-base-code via sentence-transformers) is supported; the variable exists for future expansion.
CODE_INDEX_EMBED_MODEL
HuggingFace model id. Defaults to 'jinaai/jina-embeddings-v2-base-code'. Override only if you know the model is dim-compatible.
CODE_INDEX_EMBED_DIM
Embedding dimension. Defaults to 768 (matches jina-embeddings-v2-base-code). Must match the model's output dim.
CODE_INDEX_DB
Path to the SQLite index database. Defaults to .claude/index.db relative to the working directory.
CODE_INDEX_EMBED_BATCH
Encode batch size (default 32). Lower (e.g. 8 or 4) to reduce peak memory if the GPU OOMs on large files.
CODE_INDEX_EMBED_DEVICE
Torch device override: 'cpu', 'mps', or 'cuda'. Unset = auto-detect. Set 'cpu' to avoid Apple-Silicon MPS out-of-memory errors.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "code-index": {
      "command": "uvx",
      "args": [
        "mcp-code-index"
      ],
      "env": {
        "CODE_INDEX_EMBEDDER": "<YOUR_CODE_INDEX_EMBEDDER>",
        "CODE_INDEX_EMBED_MODEL": "<YOUR_CODE_INDEX_EMBED_MODEL>",
        "CODE_INDEX_EMBED_DIM": "<YOUR_CODE_INDEX_EMBED_DIM>",
        "CODE_INDEX_DB": "<YOUR_CODE_INDEX_DB>",
        "CODE_INDEX_EMBED_BATCH": "<YOUR_CODE_INDEX_EMBED_BATCH>",
        "CODE_INDEX_EMBED_DEVICE": "<YOUR_CODE_INDEX_EMBED_DEVICE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "code-index": {
      "command": "uvx",
      "args": [
        "mcp-code-index"
      ],
      "env": {
        "CODE_INDEX_EMBEDDER": "<YOUR_CODE_INDEX_EMBEDDER>",
        "CODE_INDEX_EMBED_MODEL": "<YOUR_CODE_INDEX_EMBED_MODEL>",
        "CODE_INDEX_EMBED_DIM": "<YOUR_CODE_INDEX_EMBED_DIM>",
        "CODE_INDEX_DB": "<YOUR_CODE_INDEX_DB>",
        "CODE_INDEX_EMBED_BATCH": "<YOUR_CODE_INDEX_EMBED_BATCH>",
        "CODE_INDEX_EMBED_DEVICE": "<YOUR_CODE_INDEX_EMBED_DEVICE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "code-index": {
      "command": "uvx",
      "args": [
        "mcp-code-index"
      ],
      "env": {
        "CODE_INDEX_EMBEDDER": "<YOUR_CODE_INDEX_EMBEDDER>",
        "CODE_INDEX_EMBED_MODEL": "<YOUR_CODE_INDEX_EMBED_MODEL>",
        "CODE_INDEX_EMBED_DIM": "<YOUR_CODE_INDEX_EMBED_DIM>",
        "CODE_INDEX_DB": "<YOUR_CODE_INDEX_DB>",
        "CODE_INDEX_EMBED_BATCH": "<YOUR_CODE_INDEX_EMBED_BATCH>",
        "CODE_INDEX_EMBED_DEVICE": "<YOUR_CODE_INDEX_EMBED_DEVICE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "code-index": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-code-index"
      ],
      "env": {
        "CODE_INDEX_EMBEDDER": "<YOUR_CODE_INDEX_EMBEDDER>",
        "CODE_INDEX_EMBED_MODEL": "<YOUR_CODE_INDEX_EMBED_MODEL>",
        "CODE_INDEX_EMBED_DIM": "<YOUR_CODE_INDEX_EMBED_DIM>",
        "CODE_INDEX_DB": "<YOUR_CODE_INDEX_DB>",
        "CODE_INDEX_EMBED_BATCH": "<YOUR_CODE_INDEX_EMBED_BATCH>",
        "CODE_INDEX_EMBED_DEVICE": "<YOUR_CODE_INDEX_EMBED_DEVICE>"
      }
    }
  }
}

Claude Code

claude mcp add code-index --env CODE_INDEX_EMBEDDER=<YOUR_CODE_INDEX_EMBEDDER> --env CODE_INDEX_EMBED_MODEL=<YOUR_CODE_INDEX_EMBED_MODEL> --env CODE_INDEX_EMBED_DIM=<YOUR_CODE_INDEX_EMBED_DIM> --env CODE_INDEX_DB=<YOUR_CODE_INDEX_DB> --env CODE_INDEX_EMBED_BATCH=<YOUR_CODE_INDEX_EMBED_BATCH> --env CODE_INDEX_EMBED_DEVICE=<YOUR_CODE_INDEX_EMBED_DEVICE> -- uvx mcp-code-index