# aidex

A local MCP server that keeps a project index, answers identifier and concept queries, and stores tasks and session notes. Useful when your agent keeps re-reading files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: CSCSoftware
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/CSCSoftware/AiDex
- Updated: 2026-09-25
- HTML: https://affpapa.org/en/nevibecode/mcp/aidex

## What it does

aidex builds an index of your repository so the assistant can ask where something is defined, which methods a file holds, or what changed recently, instead of opening files one by one. Retrieval comes in three modes: exact identifier match, vector search over meaning, and a hybrid that fuses both rankings. Code, docs and workspace items all land in the same index.

The server ships 33 tools. Among them: project indexing, signatures, file tree, search across every indexed repository, a task backlog with priorities, session notes, an HTTP log receiver, and screenshots with colour reduction. A browser viewer shows the file tree, tasks and logs with live reload. Parsing covers C#, TypeScript, JavaScript, Rust, Python, C, C++, Java, Go, PHP, Ruby, HCL/Terraform, Kotlin, Swift and Astro frontmatter.

Node.js 20 or newer is required, since the server runs through `npx`. Semantic retrieval relies on embeddings computed locally. An optional LLM layer handles queries written in other languages and reorders the hits; skip it and non-English phrasing will match less well.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aidex -- npx -y aidex-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add aidex -- npx -y aidex-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aidex": {
            "command": "npx",
            "args": [
                "-y",
                "aidex-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aidex": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "aidex-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add aidex npx -y aidex-mcp
```

## When to use it
- locate a definition without opening dozens of files
- list a class's methods without reading the whole file
- see what changed in the code in the last couple of hours
- find a function by description when the name escapes you
- carry a note from one session into the next

## Example prompts
- Find where `PlayerHealth` is defined and show only the declaration lines
- List the method signatures in `src/Engine.cs`
- What changed in this project over the last two hours?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md