ZizkaDB

io.github.ZIZKA-AI-SL由 GitHub 账号 ZIZKA-AI-SL 发布v0.1.13更新于 Nov 7, 2026

Causal memory and tamper-evident audit log for AI agents: log, why, search, time travel.

已验证STDIO仅桌面数据库知识与记忆安全与监控

概览

AI 生成的概览

ZizkaDB MCP 服务器为 AI 智能体提供持久记忆、关键词与语义搜索、因果调试、时间回溯以及可验证的审计日志。

可以做什么
  • 把事件及其原因写入智能体的持久记忆
  • 按关键词和语义相似度检索已存储的历史记录
  • 追踪因果链以进行调试，并通过时间回溯重放过去的状态
  • 校验已记录的历史未被篡改（verify_chain）
  • 记录的事件会在数秒内显示在 ZizkaDB 仪表盘上
适用场景
当智能体需要跨会话保留记忆，或需要一份可审计、防篡改的“做了什么、为什么”记录时适用。也适合通过追踪原因和回看早期状态来调试智能体行为。
运行要求
以 stdio 方式在本地运行，从 PyPI 安装（pip install zizkadb-mcp 或 uvx，后者需先安装 uv）。使用托管云服务需要 ZizkaDB 账号、在仪表盘创建的智能体，并把其密钥填入 ZIZKADB_API_KEY；日志调用中的智能体名称必须与密钥匹配。自托管时设置 ZIZKADB_HOST（例如本地地址），此时会自动注入开发密钥。
安装前请注意
API 密钥（ZIZKADB_API_KEY）是创建时仅显示一次的实时凭证，请勿放入共享配置。记录的事件会发送到所配置的 ZizkaDB 主机，默认即云服务，因此智能体历史会离开本机。除非将 ZIZKADB_TELEMETRY 设为 false，启动时会发送匿名安装统计。仅注册账号不会记录事件，必须配置密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ZizkaDB，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

zizkadb-mcp

PyPI: zizkadb-mcp 0.1.13 · listed in the MCP Registry as io.github.ZIZKA-AI-SL/zizkadb-mcp

MCP server for ZizkaDB. Gives any MCP-compatible AI agent persistent memory, keyword and semantic search, causal debugging, time travel, and proof that its history is untouched (verify_chain).

Setup (managed cloud)

  1. Sign up at db.zizka.ai
  2. Dashboard → Create agent (e.g. cursor-agent) — copy the API key shown once
  3. Paste the key into your MCP config (see below)
  4. Reload MCP in Cursor — use the same agent name in log_event calls
  5. Events appear on your dashboard within seconds

Agent name must match. If your key is for cursor-agent, log with agent="cursor-agent". For many dynamic agent names, use a tenant-wide key (Settings).

Signup alone does not log events. You must create an agent + key and add it to ZIZKADB_API_KEY.

Cursor — 30 second setup

Paste into ~/.cursor/mcp.json (or .cursor/mcp.json in your project), then reload MCP:

json
{  "mcpServers": {    "zizkadb": {      "command": "uvx",      "args": ["zizkadb-mcp"],      "env": { "ZIZKADB_API_KEY": "zizkadb_live_xxxx" }    }  }}

Self-host: use the Self-hosted block below (ZIZKADB_HOST only — dev key auto-injected on localhost).

Prerequisite: install uv for uvx:

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Install

bash
pip install zizkadb-mcp# oruvx zizkadb-mcp

Self-hosted

json
{  "mcpServers": {    "zizkadb": {      "command": "uvx",      "args": ["zizkadb-mcp"],      "env": {        "ZIZKADB_HOST": "http://localhost:8000"      }    }  }}

On localhost, the dev key (zizkadb_dev_local) is auto-injected — no API key needed. Must match DEV_API_KEY in infra/.env if you changed it.

Environment variables

VariableDefaultPurpose
ZIZKADB_HOSThttps://db.zizka.aiAPI base URL
ZIZKADB_API_KEY—Required on cloud. Your key from db.zizka.ai Settings
AGENTDB_API_KEY—Legacy alias for ZIZKADB_API_KEY
AGENTDB_HOST—Legacy alias for ZIZKADB_HOST
ZIZKADB_TELEMETRYonSet false to opt out (anonymous install ping when MCP server starts)

If ZIZKADB_API_KEY is missing on cloud, MCP tools return a clear error instead of silently failing.

Links

来源：mcp/README.md，提交 233ae38

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

2
  1. v0.1.13最新Nov 7, 2026
  2. v0.1.12Oct 31, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分