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 分