Zikra — AI 智能体的团队内存

不仅仅是会话内存。这是一个为你的团队运行的每个智能体、每个人和每个项目提供的共享、受控的内存层。

License: MIT MCP

网站： zikra.dev · 自托管 · MIT 协议 · 可扩展至数百万条记忆

zikra 17 runs · 847 memories │ you@team-server │ Sonnet 4.6 │ ~/project (main) │ 387K/200K ████░░░░░░ 45%

一行命令安装

claude mcp add zikra http://localhost:8000/mcp --header "Authorization: Bearer YOUR_TOKEN"

或者添加到 ~/.claude/settings.json：

{ "mcpServers": { "zikra": { "url": "http://localhost:8000/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

还没有服务器？ → 下方的第 1 步大约需要 2 分钟。

大多数 AI 内存工具只解决一个问题：让一个智能体更好地记住一个会话。

Zikra 解决了一个更难的问题：多个人在多个项目上运行多个 AI 智能体 — 所有人共享同一个内存池，且具备正确的权限范围（将正确的人分配到正确的项目），让正确的智能体提取正确的上下文，并通过内置的卫生评分机制保持数百万条记忆的实时更新。

这不是会话内存。这是 AI 原生团队的共享大脑。

你将获得	含义
多智能体	Claude Code, Gemini CLI, Codex — 一个池，一个令牌
多人协作	每个项目拥有所有者 / 管理员 / 开发人员 / 查看者角色
多项目	隔离的命名空间；一个团队可以同时运行 `veltisai`, `design`, `global`
规模化	PostgreSQL 后端 — 处理数百万条记忆而无需重建索引
内存卫生	内置卫生提示：置信度衰减、孤立项检测、陈旧数据清理
结构化	不仅仅是“保存文本” — 决策、需求、提示词、错误、会话日志
自动保存	Stop + PreCompact 钩子自动写入每个会话

— Mukarram

Zikra 的对比优势

	Zikra	MCP Memory¹	mem0	basic-memory	MemoryMesh
跨多个 AI 工具工作	✅	❌	✅ 付费	❌	❌
具备用户角色的团队共享	✅ RBAC	❌	✅ 付费	❌	❌
多项目命名空间	✅	❌	✅ 付费	❌	❌
自托管，零云依赖	✅	✅	❌	✅	✅
通过会话钩子自动保存	✅	❌	❌	❌	❌
混合向量 + 关键词搜索	✅	❌ 仅图	✅	❌	❌
置信度衰减 / 内存卫生	✅ 内置提示	❌	❌	❌	❌
命名提示词 + 需求	✅	❌	❌	❌	❌
可扩展至数百万条记忆	✅ Postgres	❌ 内存中	✅ 云端	❌	❌
许可证	MIT	MIT	专有	MIT	MIT

¹ @modelcontextprotocol/server-memory — Anthropic 官方参考服务器。

入门指南

第 1 步 — 安装服务器

git clone https://github.com/getzikra/zikra
cd zikra
python3 -m venv .venv
source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install -e .
python3 installer.py         # interactive setup, ~2 minutes
python3 -m zikra

安装程序会创建一个 .env 文件并生成你的管理员令牌。服务器默认绑定到 http://localhost:8000。

若要从其他机器访问，请运行 cloudflared tunnel --url http://localhost:8000（免费，可获得一个永久的公共 URL，如 https://zikra.yourteam.com）。

第 2 步 — 在 Claude Code 中启用 MCP

打开 Claude Code → Settings → MCP → Add Server 并粘贴：

{
  "mcpServers": {
    "zikra": {
      "url": "http://your-server:8000/mcp",
      "headers": { "Authorization": "Bearer YOUR_ZIKRA_TOKEN" }
    }
  }
}

本地运行时，安装程序会自动执行此操作。

第 3 步 — 连接你的 AI 编码智能体

将智能体的提示词粘贴到会话中。它同时处理首次安装和更新。

Claude Code:

Fetch https://raw.githubusercontent.com/GetZikra/zikra/main/prompts/zikra-claude-code-setup.md
and follow every instruction in it.

这将安装 Stop 钩子（自动保存每个会话）、PreCompact 钩子，以及显示运行次数和内存统计信息的实时 状态栏。

更新 Zikra

服务器：

cd ~/zikra && ./update.sh

Claude Code 钩子 — 重新运行引导提示词。它会检测你现有的安装并仅刷新已更改的部分。

配置文件

配置文件	存储	钩子	额外依赖
Webhook (默认)	SQLite ¹	无	无
Auto-log	SQLite ¹	会话钩子	无
Full	SQLite ¹ 或 Postgres	钩子 + 守护进程	asyncpg (仅限 Postgres)

¹ SQLite 仅适用于本地 / 单用户。 对于团队部署，请设置 DB_BACKEND=postgres。

环境变量

变量	必需	默认值	描述
`ZIKRA_TOKEN`	是	已生成	API 的 Bearer 令牌
`OPENAI_API_KEY`	否	—	启用语义搜索。若缺失则仅支持关键词搜索。
`DB_BACKEND`	否	`sqlite`	`sqlite` 或 `postgres`
`DB_HOST`	仅 Postgres	`localhost`
`DB_PORT`	仅 Postgres	`5432`
`DB_NAME`	仅 Postgres	—
`DB_USER`	仅 Postgres	—
`DB_PASSWORD`	仅 Postgres	—
`ZIKRA_HOST`	否	`0.0.0.0`	绑定地址
`ZIKRA_PORT`	否	`8000`	HTTP 端口
`ZIKRA_DB_PATH`	否	`./zikra.db`	SQLite 数据库路径
`ZIKRA_PROJECT`	否	`main`	默认项目
`OPENAI_API_BASE`	否	`https://api.openai.com/v1`	替换为本地或兼容的嵌入端点
`ZIKRA_EMBEDDING_MODEL`	否	`text-embedding-3-small`	嵌入模型名称
`ZIKRA_DECAY_DAYS`	否	`30`	内存半衰期（天）
`ZIKRA_FREQUENCY_WEIGHT`	否	`0.1`	访问频率提升权重

结果排名方式

每个搜索结果都会经过评分：

时间 — 最近的记忆排名更高。半衰期：30 天。下限：0.05。
访问频率 — 频繁使用的提示词排名更高（对数刻度）。
置信度 — 以较低 confidence_score 保存的记忆排名较低。

命令参考

所有命令均为 POST /webhook/zikra，并携带 Authorization: Bearer <token>。

命令	别名	描述
`search`	`find`, `query`, `recall`	混合语义 + 关键词搜索
`save_memory`	`save`, `store`	保存带有嵌入的记忆
`get_memory`	`fetch_memory`	通过标题或 `id` 检索
`get_prompt`	`fetch_prompt`	检索命名提示词
`log_run`	`log_session`	记录已完成的智能体运行
`log_error`	`log_bug`	记录错误
`save_requirement`	—	保存项目需求
`save_prompt`	`write_prompt`	保存带有嵌入的提示词
`list_prompts`	`get_prompts`	列出项目的提示词
`list_requirements`	`list_reqs`	列出需求
`promote_requirement`	`promote`	更改需求类型
`create_token`	`new_token`	生成 Bearer 令牌（所有者角色）
`get_schema`	`schema`	数据库 DDL 自省
`zikra_help`	`help`	完整命令参考
`debug_protocol`	—	后端诊断

角色： owner · admin · developer · viewer

PostgreSQL 后端

DB_BACKEND=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ai_zikra
DB_USER=postgres
DB_PASSWORD=yourpassword

pip install -e ".[postgres]"

许可证

MIT — 参见 LICENSE

在 Claude Web 中设计。在 Claude Code 中执行。与整个团队共享。 Claude Web · Claude Code · Gemini CLI · Codex · 任何支持 POST 的智能体。

zikra