aidex-mcp

data-ai MCP Server

MCP Server for persistent code indexing. Gives AI assistants (Claude, Gemini, Copilot, Cursor) instant access to your codebase. 50x less context than grep.

Install Ready
data-aidata-ai
4 views36 stars9 forksv2.1.2MIT

Why This Matters

Discovered via unknown and last synced 3mo ago.

Install Ready
Source
unknown
Stars
36
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx aidex-mcp

2. Add to claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

75
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (75)

global_guideline

Persistent AI instructions & coding conventions — shared across all projects

Python

`.py`, `.pyw`

log

Universal log receiver — any program sends logs via HTTP, queryable by the AI, live in Viewer

C

`.c`, `.h`

Tools

Purpose

aidex_log

Universal log receiver — start HTTP server, query logs, live stream in Viewer

aidex_signatures

Get signatures for multiple files (glob)

aidex_unlink

Remove linked project

aidex_viewer

Open interactive project tree in browser

aidex_global_query

Search terms across ALL registered projects

19

1,200

viewer

Interactive browser UI with file tree, signatures, tasks, logs, search, and live reload

Java

`.java`

Signatures

`aidex_signature`, `aidex_signatures`

Screenshots

`aidex_screenshot`, `aidex_windows`

aidex_update

Re-index a single changed file

aidex_links

List linked projects

aidex_task

Create, read, update, delete tasks with priority and tags

aidex_global_signatures

Search methods/types by name across all projects

GET

—

10

1,900

Language

Extensions

Go

`.go`

Overview

`aidex_summary`, `aidex_tree`, `aidex_describe`, `aidex_files`

Viewer

`aidex_viewer`

aidex_remove

Remove a deleted file from index

aidex_status

Index statistics

aidex_tasks

List and filter tasks by status, priority, or tag

aidex_global_refresh

Update stats and remove stale projects from global DB

Yes

Yes

18

3,000

Category

Tools

Rust

`.rs`

Question

Tool

Sessions

`aidex_session`, `aidex_note`

aidex_query

Search by term (exact/contains/starts_with)

aidex_describe

Add documentation to summary

aidex_note

Read/write session notes (persists between sessions)

aidex_global_init

Scan directory tree, register all indexed projects in global DB

Endpoint

Method

colors

2, 4, 16, 256

TypeScript

`.ts`, `.tsx`

PHP

`.php`

Cross-Project

`aidex_link`, `aidex_unlink`, `aidex_links`, `aidex_scan`

Tool

Description

aidex_summary

Project overview

aidex_scan

Find indexed projects in directory tree

aidex_global_guideline

Store/retrieve AI guidelines and coding conventions (key-value, global)

Parameter

Values

56

4,100

JavaScript

`.js`, `.jsx`, `.mjs`, `.cjs`

Ruby

`.rb`, `.rake`

Guidelines

`aidex_global_guideline`

aidex_init

Index a project (creates `.aidex/`)

aidex_tree

File tree with statistics

aidex_files

List project files by type (code/config/doc/asset)

Tasks

`aidex_task`, `aidex_tasks`

aidex_signature

Get one file's classes + methods

aidex_link

Link another indexed project

aidex_session

Start session, detect external changes, auto-reindex

POST

`[{ ... }, ...]`

Project

Files

aidex_windows

List open windows for screenshot targeting

scale

0.1 - 1.0

aidex_global_status

List all registered projects with stats

Type

Looks like

progress

bar with warn/crit colouring

Mode

What it does

exact

Identifier match (same as `aidex_query`)

semantic

Vector KNN over embedded code+docs+workspace

aidex_screenshot

Take a screenshot (fullscreen, window, region) with optional scale + color reduction

gauge

radial tachometer (or status LED for strings)

plot

real-time line graph with grid + min/max/avg

1-10ms

## Technology - **Parser**: [Tree-sitter](https://tree-sitter.github.io/) - Real parsing, not regex - **Database**: SQLite with WAL mode - Fast, single file, zero config - **Protocol**: [MCP](https://modelcontextprotocol.io/) - Works with any compatible AI ## Project Structure ``` .aidex/ ← Created in YOUR project ├── index.db ← SQLite database └── summary.md ← Optional documentation AiDex/ ← This repository ├── src/ │ ├── commands/ ← Tool implementations │ ├── db/ ← SQLite wrapper │ ├── parser/ ← Tree-sitter integration │ └── server/ ← MCP protocol handler └── build/ ← Compiled output ``` ## Community **[GitHub Discussions](https://github.com/CSCSoftware/AiDex/discussions)** — Ask questions, share your setup, suggest ideas.

label

big value + unit