# AiDex MCP server

> Indexes your codebase so AI assistants can search code, docs, and notes with far less context than grep.

- Repository: https://github.com/CSCSoftware/AiDex
- Page: https://hostedmcp.org/servers/cscsoftware/aidex
- Transport: stdio
- Stars: 48
- License: MIT
- Latest version: 1.8.0

## Install

### Claude Code

```sh
claude mcp add aidex -- npx -y aidex-mcp
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "aidex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aidex-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"aidex","type":"stdio","command":"npx","args":["-y","aidex-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add aidex -- npx -y aidex-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.aidex]
command = "npx"
args = ["-y", "aidex-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user aidex npx -- -y aidex-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (31)

- `exact`
- `semantic`
- `aidex_init`
- `aidex_query`
- `aidex_signature`
- `aidex_signatures`
- `aidex_update`
- `aidex_remove`
- `aidex_summary`
- `aidex_tree`
- `aidex_describe`
- `aidex_link`
- `aidex_unlink`
- `aidex_links`
- `aidex_status`
- `aidex_scan`
- `aidex_files`
- `aidex_note`
- `aidex_session`
- `aidex_viewer`
- `aidex_task`
- `aidex_tasks`
- `aidex_screenshot`
- `aidex_windows`
- `aidex_global_init`
- `aidex_global_status`
- `aidex_global_query`
- `aidex_global_signatures`
- `aidex_global_refresh`
- `aidex_global_guideline`
- `aidex_log`

## FAQ

### Which languages does AiDex index?

It supports 14 languages including C#, TypeScript, JavaScript, Rust, Python, C, C++, Java, Go, PHP, Ruby, HCL/Terraform, Kotlin, and Swift.

### Does AiDex require an API key or internet connection?

No; semantic search works fully offline with local embeddings, and the LLM layer is optional and opt-in.

### Where does the AiDex index get stored?

The index is stored as a SQLite database file inside the project at .aidex/index.db.

### What search modes does AiDex offer?

It provides exact identifier matching, semantic vector search, and a hybrid mode that fuses both rankings.
