# Code Index

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/trondhindenes/code-index-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/code-index-3

## Description
Fast local source code searching using Zoekt trigram-based indexing

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "code-index": {
    "command": "npx",
    "args": ["-y","code-index-3"]
  }
}
```

## Documentation & README

# Code Index MCP Server

An MCP (Model Context Protocol) server for fast local source code searching using [Zoekt](https://github.com/sourcegraph/zoekt).

## Features

- **Fast code search**: Uses Zoekt's trigram-based indexing for fast substring and regex matching
- **Per-directory indexes**: Each indexed directory gets its own index stored in the user profile
- **Rich query language**: Supports regex, file filters, language filters, and boolean operators
- **Cross-platform**: Works on macOS and Linux

## Installation
This server is available on the [MCP Registry](https://registry.modelcontextprotocol.io/?q=trondhindenes%2Fcode-index).

### Download Pre-built MCPB bundle (experimental)

Download the appropriate `.mcpb` bundle for your platform from the [GitHub Releases](https://github.com/trondhindenes/code-index-mcp/releases) page:

- `code-index-mcp-darwin-arm64.mcpb` - macOS Apple Silicon
- `code-index-mcp-darwin-amd64.mcpb` - macOS Intel
- `code-index-mcp-linux-amd64.mcpb` - Linux x64
- `code-index-mcp-linux-arm64.mcpb` - Linux ARM64

The `.mcpb` file is a ZIP archive containing the binary and manifest. You can open it directly in Claude Desktop in order to install it


### Manual installation (recommended)
In order to get the binary onto your computer, you can do one of the following:
#### Download from releases
Go to [GitHub Releases](https://github.com/trondhindenes/code-index-mcp/releases) and download 
the appropriate file (not mcpb but the tar/gzipped ones corresponding to your platform).
For example:
```shell
curl -sL https://github.com/trondhindenes/code-index-mcp/releases/download/1.0.13/code-index-mcp-darwin-arm64.tar.gz | tar xz
chmod +x code-index-mcp
```

#### Using Go

```bash
go install github.com/trondhindenes/code-index-mcp@latest
```

#### Build from Source

```bash
git clone https://github.com/trondhindenes/code-index-mcp
cd code-index-mcp
go build -o code-index-mcp .
```


## Configuration
Now that you have the binary installed locally, you can register it in your tools of choice. 
This should not be necessary if you installed via mcpb bundle but your mileage may vary.

### Claude Desktop

Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "code-index": {
      "command": "/path/to/code-index-mcp"
    }
  }
}
```

### Claude Code
Run the following:
```shell
claude mcp add --scope user --transport stdio code-index /path/to/code-index-mcp
```

### Environment Variables

- `CODE_INDEX_DIR`: Override the default index storage location

Default index locations:
- macOS: `~/Library/Application Support/code-index/`
- Linux: `~/.local/share/code-index/` or `$XDG_DATA_HOME/code-index/`

## Available Tools

### `index_directory`

Index a source code directory for fast searching.

**Parameters:**
- `directory` (required): The path to the directory to index

**Example:**
```
Index the directory /Users/me/projects/myapp
```

### `search_code`

Search for code across indexed directories. Returns compact grep-like output to minimize context window usage.

**Parameters:**
- `query` (required): The search query using Zoekt syntax
- `directory` (optional): Limit search to a specific indexed directory
- `max_files` (optional): Maximum files to return (default: 20)
- `max_lines_per_file` (optional): Maximum matches per file (default: 3)
- `files_only` (optional): Only return file paths, no line content (default: false)

**Output Format:**
```
/path/to/file.go:42: matching line content here
/path/to/file.go:58: another matching line
  ... and 5 more matches in this file
```

**Query Syntax Examples:**
- `func main` - Simple text search
- `file:\.go$ func main` - Search only in .go files
- `lang:python class.*Model` - Search in Python files
- `-test func main` - Exclude files containing "test"
- `case:yes MyFunc` - Case-sensitive search

### `list_indexes`

List all indexed directories and their locations.

### `delete_index`

Delete the index for a specific directory.

**Parameters:**
- `directory` (required): The path to the directory whose index should be deleted

### `index_info`

Get information about the indexing configuration, including storage location.

## Skipped Directories

The following directories are automatically skipped during indexing:
- Hidden directories (starting with `.`)
- `node_modules`, `vendor`, `__pycache__`
- `target`, `build`, `dist`
- `venv`, `.venv`, `env`, `.env`

## Skipped Files

Binary files and common non-code files are automatically skipped, including:
- Executables (`.exe`, `.dll`, `.so`, `.dylib`)
- Archives (`.zip`, `.tar`, `.gz`)
- Images (`.png`, `.jpg`, `.gif`)
- Documents (`.pdf`, `.doc`, `.docx`)

## License

MIT