如何安裝 Code Index？

在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式，而不是 PlugMCP 代理伺服器。

Code Index 需要 API 金鑰嗎？

發布者列出了以下環境變數：CODE_INDEX_EMBEDDER, CODE_INDEX_EMBED_MODEL, CODE_INDEX_EMBED_DIM, CODE_INDEX_DB, CODE_INDEX_EMBED_BATCH, CODE_INDEX_EMBED_DEVICE。

Code Index 使用哪種傳輸方式？

Code Index 透過 stdio 在本機執行。

Code Index 上次檢查是什麼時候？

上次檢查時間：2026-11-09。 SQLite-backed hybrid (vector + FTS) code search index for Claude Code over MCP.

Code Index MCP 伺服器

接入你的智能体

新增此伺服器

發布者自己的指令。不是 PlugMCP 端點。

新增至 Cursor 新增至 VS Code 在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

本機指令

uvx mcp-code-index==1.0.6

發布者提供的憑證

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 Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。

shClaude Code

1CODE_INDEX_EMBEDDER=<value> CODE_INDEX_EMBED_MODEL=<value> CODE_INDEX_EMBED_DIM=<value> CODE_INDEX_DB=<value> CODE_INDEX_EMBED_BATCH=<value> CODE_INDEX_EMBED_DEVICE=<value> claude mcp add io.github.achreftlili-code-index -- uvx mcp-code-index==1.0.6

在終端機中執行。

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.achreftlili-code-index": {4      "command": "uvx",5      "args": [6        "mcp-code-index==1.0.6"7      ],8      "env": {9        "CODE_INDEX_EMBEDDER": "<value>",10        "CODE_INDEX_EMBED_MODEL": "<value>",11        "CODE_INDEX_EMBED_DIM": "<value>",12        "CODE_INDEX_DB": "<value>",13        "CODE_INDEX_EMBED_BATCH": "<value>",14        "CODE_INDEX_EMBED_DEVICE": "<value>"15      }16    }17  }18}

claude_desktop_config.json

本機 · pypi發布者安裝方式逐步說明：在 Claude 中新增

遠端 URL 還是本機指令？兩種安裝方式的差異

在 PlugMCP 上執行

用我們的金鑰與日誌託管一份副本。

这是你新建的服务器，不是此条目的官方端点。若要用发布方的 URL 与凭证，请使用上方安装面板。

啟動

伺服器資訊

本機

傳輸方式: stdio
版本

來自發布者

文件

code-index

A local, SQLite-backed code index for Claude Code, exposed over MCP. It replaces blind Read / Grep / Glob exploration with targeted retrieval — "where is parseAuthToken defined", "what calls Indexer.reindex_all", "find the rate-limiting code" — answered in milliseconds against an offline index.

No API keys. No external services. The embedder runs locally on your machine.

Tool	Purpose
`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.
`module_outline`	Symbols across a directory subtree in one call. Use instead of looping `file_outline`.
`where_am_i`	Given `path` + `line`, returns the innermost symbol and the full enclosing chain.
`get_symbol_body`	Full chunk for a `symbol_id` from `symbol_lookup` / `code_search` / `file_outline`.
`get_symbol_bodies`	Batch version of `get_symbol_body` (up to 20 ids per call).
`callers`	Symbols that CALL the given symbol. `depth` (1-5) expands transitively.
`callees`	Symbols that the given symbol CALLS. `depth` (1-5) expands transitively.
`references`	Non-call uses (subclasses, free identifier references). Companion to `callers` / `callees`.
`trace`	Build a call-graph tree from an entry symbol; `flat=true` returns nodes/edges for cheap LLM scans.
`file_imports`	Files this file imports (`direction=imports`) or that import it (`direction=imported_by`).
`recent_changes`	Files touched in the last N git commits.
`propose_rename`	v1: same-file rename. Returns an edit list the agent applies via its own `Edit` tool; refuses on clash.

Tool / op	Purpose
`admin op=init`	Build or refresh the index. Incremental by default; `force=true` rebuilds from scratch.
`admin op=setup_check`	Diagnose hook wiring + embedder + host. Round-trip-tests the hook end-to-end.
`admin op=install_hook`	Wire the auto-reindex `PostToolUse` hook into `.claude/settings.json`. Idempotent.
`admin op=stats`	Read-only: file counts by language, symbol totals, embed model fingerprint, last-index time.
`admin op=verify`	Integrity sweep: orphan rows, parse-failure files, dangling edges.

Var	Default	When to set it
`CODE_INDEX_EMBED_DEVICE`	auto	Force the torch device: `cpu`, `mps`, or `cuda`. Set `cpu` on Apple Silicon if `init` fails with MPS out-of-memory.
`CODE_INDEX_EMBED_BATCH`	`32`	Encode batch size. Lower (e.g. `8` or `4`) to cut peak GPU memory while staying on `mps`/`cuda`.
`CODE_INDEX_DB`	`.claude/index.db`	Override the SQLite index path (e.g. to share an index across sibling worktrees).

Var	Default	Notes
`CODE_INDEX_EMBEDDER`	`jina`	Only `jina` (local sentence-transformers) is supported today; the variable exists for future expansion.
`CODE_INDEX_EMBED_MODEL`	`jinaai/jina-embeddings-v2-base-code`	HuggingFace model id. Only override if you know the model is dim-compatible (768d).
`CODE_INDEX_EMBED_DIM`	`768`	Must match the embedding model's output dimension.

新增此伺服器

用我們的金鑰與日誌託管一份副本。

伺服器資訊

文件

code-index

How it works (30-second tour)

Tools

Retrieval

Admin

Requirements

Quick start (Claude Code)

Alternative: permanent install (no uvx)

Optional: keep the index live as you edit

In other MCP-compatible agents

From source (development)

Configuration

Troubleshooting

Layout

Code Index

工具

問題

如何安裝 Code Index？

Code Index 需要 API 金鑰嗎？

Code Index 使用哪種傳輸方式？

Code Index 上次檢查是什麼時候？