zikra
OfficialZikra — AI 智能体的团队内存
不仅仅是会话内存。这是一个为你的团队运行的每个智能体、每个人和每个项目提供的共享、受控的内存层。
网站: 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 — 一个池,一个令牌 |
多人协作 | 每个项目拥有所有者 / 管理员 / 开发人员 / 查看者角色 |
多项目 | 隔离的命名空间;一个团队可以同时运行 |
规模化 | PostgreSQL 后端 — 处理数百万条记忆而无需重建索引 |
内存卫生 | 内置卫生提示:置信度衰减、孤立项检测、陈旧数据清理 |
结构化 | 不仅仅是“保存文本” — 决策、需求、提示词、错误、会话日志 |
自动保存 | Stop + PreCompact 钩子自动写入每个会话 |
— Mukarram
Related MCP server: mcp-memory-graph
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.shClaude Code 钩子 — 重新运行引导提示词。它会检测你现有的安装并仅刷新已更改的部分。
配置文件
配置文件 | 存储 | 钩子 | 额外依赖 |
Webhook (默认) | SQLite ¹ | 无 | 无 |
Auto-log | SQLite ¹ | 会话钩子 | 无 |
Full | SQLite ¹ 或 Postgres | 钩子 + 守护进程 | asyncpg (仅限 Postgres) |
¹ SQLite 仅适用于本地 / 单用户。 对于团队部署,请设置 DB_BACKEND=postgres。
环境变量
变量 | 必需 | 默认值 | 描述 |
| 是 | 已生成 | API 的 Bearer 令牌 |
| 否 | — | 启用语义搜索。若缺失则仅支持关键词搜索。 |
| 否 |
|
|
| 仅 Postgres |
| |
| 仅 Postgres |
| |
| 仅 Postgres | — | |
| 仅 Postgres | — | |
| 仅 Postgres | — | |
| 否 |
| 绑定地址 |
| 否 |
| HTTP 端口 |
| 否 |
| SQLite 数据库路径 |
| 否 |
| 默认项目 |
| 否 |
| 替换为本地或兼容的嵌入端点 |
| 否 |
| 嵌入模型名称 |
| 否 |
| 内存半衰期(天) |
| 否 |
| 访问频率提升权重 |
结果排名方式
每个搜索结果都会经过评分:
时间 — 最近的记忆排名更高。半衰期:30 天。下限:0.05。
访问频率 — 频繁使用的提示词排名更高(对数刻度)。
置信度 — 以较低
confidence_score保存的记忆排名较低。
命令参考
所有命令均为 POST /webhook/zikra,并携带 Authorization: Bearer <token>。
命令 | 别名 | 描述 |
|
| 混合语义 + 关键词搜索 |
|
| 保存带有嵌入的记忆 |
|
| 通过标题或 |
|
| 检索命名提示词 |
|
| 记录已完成的智能体运行 |
|
| 记录错误 |
| — | 保存项目需求 |
|
| 保存带有嵌入的提示词 |
|
| 列出项目的提示词 |
|
| 列出需求 |
|
| 更改需求类型 |
|
| 生成 Bearer 令牌(所有者角色) |
|
| 数据库 DDL 自省 |
|
| 完整命令参考 |
| — | 后端诊断 |
角色: owner · admin · developer · viewer
PostgreSQL 后端
DB_BACKEND=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ai_zikra
DB_USER=postgres
DB_PASSWORD=yourpasswordpip install -e ".[postgres]"许可证
MIT — 参见 LICENSE
在 Claude Web 中设计。在 Claude Code 中执行。与整个团队共享。 Claude Web · Claude Code · Gemini CLI · Codex · 任何支持 POST 的智能体。
This server cannot be deployed
Maintenance
Related MCP Connectors
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
- mcpOAuthai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Related MCP Servers
AlicenseAqualityBmaintenanceSelf-hosted MCP-native agent memory server. Gives AI agents persistent, decay-weighted memory via 83 MCP tools — no cloud, full control. RocksDB+HNSW backend. Works with Claude Code, Cursor, and any MCP-compatible agent.148MIT- AlicenseAqualityCmaintenanceLocal-first memory for Claude Code and any MCP client: hybrid vector + keyword search and a bi-temporal knowledge graph in one SQLite file. Local embeddings, no API key, $0/token.51108 npm2PolyForm Noncommercial 1.0.0
- FlicenseNot gradedqualityDmaintenancePersistent memory server for AI assistants with semantic search and three-layer context (global, project, personality). Works with MCP-compatible AI tools like Claude Code, Cursor, Continue, Cline, and more.1-
- AlicenseNot gradedqualityCmaintenanceA persistent memory MCP server for Claude Code that enables long-term recall across sessions via hybrid search, code intelligence, and tools for reading/writing memory.9 npm5MIT