zikra

Zikra 是一个基于 MCP 的持久化内存服务器，旨在与 Claude Code 和其他 AI 编码代理一起使用。README 将其描述为团队用于运行多个代理、人员和项目的共享、受控内存层。服务器可以本地运行，默认绑定到 localhost:8000，并使用 Bearer 令牌进行身份验证。可以通过 URL 和 Authorization 头将其作为 MCP 服务器添加到 Claude Code，项目还提供了一个交互式安装程序和一个更新脚本。 主要功能包括多代理支持（Claude Code、Gemini CLI、Codex 或任何可以 POST 的代理）、基于角色的访问（拥有者、管理员、开发者、查看者），以及隔离的项目命名空间，以便一个团队可以为每个项目维护单独的内存池。内存是结构化的，而不是纯文本：命令集涵盖保存记忆和提示、记录运行和错误、保存和列出需求、提升需求类型，以及按标题或 ID 检索项目。搜索被描述为混合语义加关键词（当启用嵌入时）；如果没有 OPENAI_API_KEY，则回退到仅关键词。排名考虑年龄、访问频率和置信度分数。 存储可以使用 SQLite 进行本地或单用户设置，或使用 PostgreSQL 进行团队部署。PostgreSQL 后端通过 DB_BACKEND 和 DB_* 环境变量进行配置，并提供了一个额外的 postgres 安装选项。仓库描述还提到了 pgvector 和 n8n 作为堆栈的一部分，并记录了 webhook 命令端点 /webhook/zikra。嵌入可以使用 OpenAI 或兼容的端点，通过 OPENAI_API_BASE 进行配置。配置选项包括令牌、数据库设置、绑定地址、端口、默认项目、嵌入模型、衰减天数和频率权重。 对于 Claude Code，设置提示会安装 Stop 和 PreCompact 钩子，以及一个状态栏，用于自动记录会话。还描述了一个内置的卫生提示，用于置信度衰减、孤儿检测和过期清理。该项目采用 MIT 许可证。