Skip to main content
Glama
getzikra
by getzikra

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


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.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 的智能体。

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Self-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.
    14
    8
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Persistent 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
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    A 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 npm
    5
    MIT