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?

Aidex MCP server exists for a simple reason — assistants are far more useful when they can act on Aidex directly instead of describing what you should do. 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.

What the assistant can call

Once Aidex is connected, these are the calls the assistant has available:

  • Category — Tools
  • Signatures — signature, signatures
  • Cross-Project — link, unlink, links, scan
  • Guidelines — global_guideline
  • Sessions — session, note
  • Screenshots — screenshot, windows
  • Viewer — viewer
  • Overview — aidex_summary, aidex_tree, aidex_describe, aidex_files
  • Tasks — aidex_task, aidex_tasks
  • aidex_init — Index a project (creates .aidex/)
  • aidex_query — Search by term (exact/contains/starts_with)
  • aidex_signature — Get one file's classes + methods

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 .nvmrcnvm use picks the right version automatically.

Setting it up

aidex-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Plenty of browser automation servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Aidex's toolset — Category, Signatures, Cross-Project and 11 more — is a fair guide to whether it matches your workflow. It is maintained by cscsoftware; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Aidex.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the aidex mcp server does with a few real requests.

Available tools

ToolWhat it does
CategoryTools
Signaturessignature, signatures
Cross-Projectlink, unlink, links, scan
Guidelinesglobal_guideline
Sessionssession, note
Screenshotsscreenshot, windows
Viewerviewer
Overviewaidex_summary, aidex_tree, aidex_describe, aidex_files
Tasksaidex_task, aidex_tasks
aidex_initIndex a project (creates .aidex/)
aidex_querySearch by term (exact/contains/starts_with)
aidex_signatureGet one file's classes + methods
aidex_signaturesGet signatures for multiple files (glob)
aidex_updateRe-index a single changed file

How to install the Aidex MCP server

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

Add to claude_desktop_config.json, then restart Claude Desktop.

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 .nvmrcnvm 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

It connects Aidex to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Category, Signatures, Cross-Project, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Aidex directly.