How do I install the aidex mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Aidex MCP Server

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

Local serverstdioPython

What is the Aidex 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.

What you get

AiDex is an MCP server that gives AI coding assistants a memory, semantic search, and live telemetry — local-first, model-agnostic. Works with any MCP-compatible AI assistant: Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, VS Code Copilot, and more.

Configuration and credentials

Node.js ≥ 20 (check with node --version) - macOS: brew install node or nvm install 20 && nvm use 20 - Linux: use your package manager or nvm - Windows: nodejs.org - If you use nvm, the repo ships a .nvmrc — nvm use picks the right version automatically.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
aidex_init	Index a project (creates .aidex/)
aidex_query	Search by term (exact/contains/starts_with)
aidex_signature	Get one file's classes + methods
aidex_signatures	Get signatures for multiple files (glob)
aidex_update	Re-index a single changed file
aidex_remove	Remove a deleted file from index
aidex_summary	Project overview
aidex_tree	File tree with statistics
aidex_describe	Add documentation to summary
aidex_link	Link another indexed project
aidex_unlink	Remove linked project
aidex_links	List linked projects
aidex_status	Index statistics
aidex_scan	Find indexed projects in directory tree
aidex_files	List project files by type (code/config/doc/asset)
aidex_note	Read/write session notes (persists between sessions)
aidex_session	Start session, detect external changes, auto-reindex
aidex_viewer	Open interactive project tree in browser
aidex_task	Create, read, update, delete tasks with priority and tags
aidex_tasks	List and filter tasks by status, priority, or tag
aidex_screenshot	Take a screenshot (fullscreen, window, region) with optional scale + color reduction
aidex_windows	List open windows for screenshot targeting
aidex_global_init	Scan directory tree, register all indexed projects in global DB
aidex_global_status	List all registered projects with stats
aidex_global_query	Search terms across ALL registered projects
aidex_global_signatures	Search methods/types by name across all projects
aidex_global_refresh	Update stats and remove stale projects from global DB
aidex_global_guideline	Store/retrieve AI guidelines and coding conventions (key-value, global)
aidex_log	Universal log receiver — start HTTP server, query logs, live stream in Viewer

How to install the Aidex MCP Server

{
  "mcpServers": {
    "aidex": {
      "type": "stdio",
      "command": "aidex",
      "env": {}
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js ≥ 20 (check with node --version) - macOS: brew install node or nvm install 20 && nvm use 20 - Linux: use your package manager or nvm - Windows: nodejs.org - If you use nvm, the repo ships a .nvmrc — nvm use picks the right version automatically.

Example prompts to try

“Use Aidex to Category.”
“Use Aidex to Signatures.”
“Use Aidex to Cross-Project.”

Frequently asked questions

MCP Server for persistent code indexing. Gives AI assistants (Claude, Gemini, Copilot, Cursor) instant access to your codebase. 50x less context than grep. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.