用途
memex 为 AI 编程智能体提供持久化的工程上下文记忆。它解决的核心问题是：编程智能体通常基于代码的某个快照工作，当队友推送、其他智能体编辑文件或分支移动后，智能体仍按先前读取的内容行动。memex 持续构建代码库的双时态知识图谱，让智能体的工程上下文随代码变化保持最新。
主要能力
- 构建双时态知识图谱：涵盖模块、符号、决策、问题、证据与代码演化。
- 通过 MCP 协议服务：面向 Claude Code、Cursor、Gemini CLI 及任何 MCP 客户端。
- 解析与存储：使用 Tree-sitter 和 Gemini Flash 解析，经 Graphiti 写入 Neo4j。
- 14 个 MCP 工具：八个读取、四个写入、两个分析。
- 分层聚类：memex cluster 在混合边图上运行分层 Leiden 算法。
- 三档置信度衰减：置信度不是存储的可变数字，而是在查询时根据 base_confidence、验证状态、距上次强化时间和访问次数计算。
- 实时上下文（v1）：集成 Claude Code 与 Codex，每次会话以正确上下文开始，每次编辑对照当前代码检查，并告知智能体具体变更。
- 令牌节省度量：在本地 SQLite 数据库（~/.config/memex/telemetry.db）跟踪令牌减少指标与人工审查操作，可通过 CLI 或 HTTP MCP 传输查询，返回周期摘要、顶级工具、智能体客户端和验证健康度等聚合信息。
- Hermes 集成：只读集成，memex 通过有界的 ContextPacket 提供仓库工程上下文，不摄取 Hermes 的 state.db、转录、提示或工具结果。
- 自托管团队部署：支持一个 Neo4j 加一个 memex-server 的共享团队设置，默认开启认证，Neo4j 端口不暴露给主机。
使用方式
- 安装：可通过 Claude Code 市场安装，安装或升级后首次启动会下载 Python 依赖（约 40 秒），可能超过 Claude Code 的 MCP 连接超时一次，建议先预热再重启。若仍显示连接超时，打开 /mcp 并重新连接 memex。若工具提示无法连接 Neo4j，启动 Neo4j（例如 docker start memex-neo4j），工具无需重启即可恢复。
- 手动接线：可在 .claude/settings.json、~/.cursor/mcp.json、~/.gemini/settings.json、~/.codex/config.toml 中配置。
- 前置条件：需要用户自行运行的 Neo4j 5 服务器（不要求 Docker）。钩子仅写入检出项目自身的项目配置，memex 不索取或存储客户端凭据。
- 团队部署：参见 docker/TEAM-DEPLOY.md 了解完整流程、初始管理员密钥获取以及需避免的 down -v 陷阱。
- 开发：uv sync --all-extras 安装开发工具链；uv run pytest -m "not integration" 运行离线测试套件；提交 PR 前运行 uv run ruff check .。版本升级需同步更新 pyproject.toml、npm/package.json、server.json 和团队 Docker 镜像标签。
适用场景
- 使用 Claude Code、Cursor、Gemini CLI、Codex 等 AI 编程智能体的开发者，希望智能体始终基于最新代码上下文工作。
- 团队协作开发，需要共享的工程知识图谱与上下文服务。
- 需要追踪令牌节省与人工审查操作的项目。
- 需要将仓库工程上下文以只读方式提供给 Hermes 等个人记忆系统的场景。
限制
- 需要用户自行运行 Neo4j 5 服务器。
- Hermes 集成为只读，memex 不摄取 Hermes 的 state.db、转录、提示或工具结果。
- memex 不作为个人记忆或原始会话状态的来源。
- 首次启动下载 Python 依赖可能超过 Claude Code 的 MCP 连接超时一次。
- 项目采用 MIT 许可证。
其他信息
- 评估记录见 BENCHMARK.md，发布历史见 CHANGELOG.md，报告流程见 SECURITY.md，贡献方式见 CONTRIBUTING.md。
- v1 设计与评估记录位于 docs/v1/，v0.9 架构位于 docs/architecture/v0.9/。
- 作者：Hill Patel（@STiFLeR7），核心贡献者与维护者包括 Hill Patel（架构师与维护者）和 Nirvaan Lagishetty（首席贡献者与维护者）。
- 名称源自 Vannevar Bush 1945 年提出的 memex 概念。
