用途：iai-mcp 是本地运行的 MCP 记忆服务器，为 Claude Code、Codex CLI 等 AI 编程助手提供长期记忆，逐字捕获每轮对话，加密后在会话开始时自动召回相关上下文，数据全部留在本地且无遥测。
主要能力：宣称在 1 万条记忆下逐字召回率≥99%、p95 召回延迟<100ms；使用 AES-256-GCM 静态加密；通过钩子自动捕获与召回；采用 LanceDB 向量存储与 bge-small-en-v1.5 嵌入；支持后台整理与重复合并。
安装与用法：需 Python 3.11/3.12、Node 18+，推荐 Apple Silicon。执行 git clone https://github.com/CodeAbra/iai-mcp.git，cd iai-mcp，bash scripts/install.sh 完成安装，并将 $HOME/.local/bin 加入 PATH。用 iai-mcp capture-hooks install [--target {claude|codex|all}] 安装捕获钩子，再通过 claude mcp add iai-mcp -- node "$(pwd)/mcp-wrapper/dist/index.js" 或编辑配置文件连接 MCP 主机。常用命令包括 iai-mcp doctor、daemon status、query、list、export、clear、stats、migrate reembed/rebuild-graph/compact。
适用场景与限制：适合需要跨会话保留编程上下文的本地开发环境。目前为 macOS（Apple Silicon 已测试），Linux/Windows 支持计划中；Python 3.13 可能存在 torch 兼容问题。安装约需 500 MB 磁盘，记忆约每 1000 轮增长 1-2 MB。加密密钥丢失后数据不可恢复。会话开始召回会增加 1k-3k token（热）或最多 8k（冷）。空闲 5 分钟执行整理，期间 socket 短暂不可用。insights 默认关闭，开启后可选调用 Anthropic API。