AiDex 是一个面向 AI 编程助手的持久化代码索引 MCP 服务器，由 CSCSoftware 开发。其核心目标是让 AI 助手（如 Claude Code、Claude Desktop、Cursor、Windsurf、Gemini CLI、VS Code Copilot 等 MCP 兼容客户端）在不反复 grep 和阅读整个文件的情况下，快速、精确地查询代码库。官方称可减少 50-80% 用于代码导航的上下文消耗，单次搜索约消耗 50 tokens，而 grep 往往需要 2000+ tokens。
【用途】 为 AI 编程智能体提供“记忆”与代码库的即时访问能力。索引一次后，AI 可以查询标识符、函数签名、文件结构，而无需逐文件阅读。索引以 SQLite 文件形式保存在项目内的 .aidex/index.db 中，本地优先、模型无关。
【主要能力】
- 持久化索引：使用 Tree-sitter 真实解析代码，索引标识符而忽略关键字和噪音；索引在会话之间持久保留，支持增量更新（仅重新索引改动的文件），排除文件自动清理。
- 三种搜索模式：精确（标识符）、语义（概念）、混合（RRF 融合）。语义模式通过本地嵌入将代码、文档和工作区条目统一排名；可选 LLM 层可在配置 Anthropic / OpenAI / OpenRouter / Ollama / HuggingFace API 密钥后翻译非英语查询、扩展模糊查询、重排候选结果。隐私开关 llm_send_code 默认关闭，仅发送查询与元数据。
- 时间过滤：支持 modified_since 和 modified_before，格式如 30m、2h、1d、1w 或 ISO 日期，便于查找“最近一小时的改动”。
- 记忆与任务：笔记、任务、会话笔记跨会话持久保存，任务支持优先级、状态、标签、历史日志、到期日与重复间隔；每次 aidex_session 调用会检查所有项目的逾期任务。
- 跨项目查询：全局初始化后可在所有已索引项目间搜索，自动跳过包含子项目的父项目，结果内存缓存 5 分钟。
- Log Hub：任何程序可通过 HTTP POST 发送日志，AI 通过 MCP 查询，Viewer 以 WebSocket 实时展示；支持级别过滤、环形缓冲区（默认 10000 条）、可选 SQLite 持久化与 7 天自动清理。
- 截图与窗口工具：支持全屏、活动窗口、指定标题窗口截图，可缩放和降低颜色数以适配 LLM。
- 全局指南：在 ~/.aidex/global.db 中存储跨项目的编码约定、审查清单、发布清单和 AI 指令。
【使用方式】 需要 Node.js ≥ 20。全局安装：npm install -g aidex-mcp。安装后自动运行 setup，检测已安装的 AI 客户端并注册 MCP 服务器，同时向 ~/.claude/CLAUDE.md、~/.gemini/GEMINI.md 等写入使用说明。可手动执行 aidex setup / aidex unsetup，或设置 AIDEX_NO_SETUP=1 跳过。也可在 Claude Code、Claude Desktop、Gemini CLI、VS Code Copilot 等客户端中手动配置 MCP 服务器，服务器名称建议使用 "aidex" 以获得 aidex_query、aidex_signature 等工具前缀。随后让 AI 执行 aidex_init 索引项目，再使用 aidex_query、aidex_signature 等查询。官方提供 33 个工具。
【适用场景】 大型代码库中快速定位定义与用法；减少 AI 上下文浪费；跨会话保留任务与笔记；跨多个仓库统一搜索；让 AI 观察程序运行时日志；为 AI 提供团队约定与审查清单。
【限制】 语义搜索与 LLM 层需要本地嵌入或可选 API 密钥（后者为可选项，纯嵌入可离线工作）。Log Hub 为即发即弃模式，服务器未运行时 POST 会静默失败。跨项目查询受 SQLite ATTACH 数量限制（按 8 个一批处理）。当前支持 14 种语言：C#、TypeScript、JavaScript、Rust、Python、C、C++、Java、Go、PHP、Ruby、HCL/Terraform、Kotlin、Swift，外加 Astro frontmatter。
