# Codeix [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/montanetech/codeix  
**GitHub Stars:** 9  
**npm Downloads (last month):** 180  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/codeix

## Description
Fast semantic code search for AI agents — find symbols, references, and callers across any codebase

## Tools
Capabilities this server exposes over MCP:

- **explore** — Explore project structure: metadata, subprojects, files grouped by directory
- **search** — Unified full-text search across symbols, files, and texts (FTS5, BM25-ranked) with scope/kind/path/project filters
- **get_file_symbols** — List all symbols in a file
- **get_children** — Get children of a class/module
- **get_callers** — Find all places that call or reference a symbol
- **get_callees** — Find all symbols that a function/method calls
- **flush_index** — Flush pending index changes to disk

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "codeix": {
    "command": "npx",
    "args": ["-y","codeix"]
  }
}
```

## Documentation

## What the Codeix MCP server does

The Codeix MCP server gives AI coding agents a structured view of one or more local codebases. Instead of returning only matching text, its index records files, symbols, signatures, line ranges, kinds, and parent relationships. Agents can use this information to locate definitions, understand project layout, inspect class or module members, and trace calls and references.

The index is stored in a `.codeindex` directory containing a manifest plus JSONL files for source files, symbols, and text entries. Because these files are plain and portable, they can be inspected with standard JSON tools and committed alongside a repository. Dependency indexes can also be discovered and mounted when the server queries a project.

Supported parsing includes Python, Rust, JavaScript, TypeScript, Go, Java, C, C++, Ruby, C#, and Markdown. HTML, Vue, Svelte, and Astro files can expose embedded JavaScript or TypeScript for indexing. Markdown headings become section symbols, while fenced code blocks are indexed as text entries.

## How it works

Run `codeix build` to parse source files and write the index. Running `codeix` or `codeix serve` starts the MCP server; the default mode watches for changes, while `serve --no-watch` disables watching. A root directory can be supplied with `-r`, and directory discovery treats each folder containing `.git/` as a separate project.

Queries run against the local index. The `search` tool combines symbol, file, and text search with FTS5 and BM25 ranking. Scope, symbol kind, path, and project filters narrow results. Text scope is intended for comments, docstrings, and string literals, while symbol-oriented results include structural metadata.

## Setup and configuration

Install the same standalone binary through npm or npx, pip or uvx, Cargo, Homebrew, or a source build. Examples include `npx codeix`, `uvx codeix`, `cargo install codeix`, and `brew install codeix`. The project states that the binary has no runtime dependencies.

Add the executable to an MCP client configuration using a stdio command such as:

```json
{
  "mcpServers": {
    "codeix": {
      "command": "codeix"
    }
  }
}
```

The documented examples are Claude Desktop and Cursor. Codeix is local-only and does not require network access or API keys. Build an index before querying a new project, unless a committed `.codeindex` is already available.

## Tools and capabilities

The Codeix MCP server exposes seven tools:

- `explore` returns project metadata, subprojects, and files grouped by directory.
- `search` performs filtered, ranked searches across symbols, files, and indexed text.
- `get_file_symbols` lists symbols found in a selected file.
- `get_children` returns the members or nested symbols of a class or module.
- `get_callers` finds locations that call or reference a symbol.
- `get_callees` lists symbols called by a function or method.
- `flush_index` writes pending index changes to disk.

## Limitations and notes

Language support depends on compile-time feature flags, although the listed language features are enabled by default. The server indexes supported source formats and does not provide a general-purpose semantic analysis claim beyond the listed navigation and search operations. It is designed for local repositories and offline use. Its license is dual MIT OR Apache-2.0.

_Full upstream README: https://allmcps.com/mcp/codeix/readme_