Zekra

io.github.fadymondy由 GitHub 帳號 fadymondy 發布v0.1.0更新於 Nov 1, 2026

Long-term memory and a knowledge graph for AI agents: recall, notes, secrets and data sources.

已驗證Streamable HTTP可網頁執行資料庫知識與記憶AI 與機器學習

概覽

AI 產生的概覽

Zekra 是託管的長期記憶與知識圖譜服務，讓 AI 助理跨工作階段保存、檢索與整理所學內容。

可以做什麼
  • 保存、檢索、讀取、編輯與軟遺忘記憶，採向量加 BM25 混合檢索、重排並附上引用
  • 查詢知識圖譜：遍歷實體與具型別的關聯，尋找鄰居與路徑，檢視本體結構
  • 管理大腦與存取權限：列出大腦、授權與權杖，在代理之間共享記憶
  • 管理密鑰保險庫，檢視知識缺口與活動日誌
  • 接入外部資料來源（text、markdown、crawler、github、sql、webhook），切塊後寫入記憶
  • 透過工具呼叫型代理與某個大腦對話，回答附引用與可稽核軌跡
適用情境
適合希望助理在工作階段之間或跨多個代理延續知識、依專案或團隊隔離記憶命名空間，或依據整理好的知識圖譜給出附引用回答的情境。
執行需求
遠端 MCP 端點 mcp.zekra.dev，使用 Streamable HTTP 與 OAuth 登入。需要 app.zekra.dev 上的託管帳號、一個大腦與存取權杖；或自架 Docker Compose 部署（含 VectorChord 的 Postgres、Go API、主控台、TEI 嵌入與重排模型，約 6 GB 磁碟）並自行設定密鑰。
安裝前請注意
服務會保存代理與使用者提供的內容，其中包含密鑰保險庫，應視為敏感資料並依代理分別限定權杖。寫入會更新或作廢既有事實而非硬刪除，歷史仍可查詢。crawler、github、sql、webhook 等資料來源會把外部內容拉進大腦。自架部署需設定 POSTGRES_PASSWORD、AUTH_SECRET、ZEKRA_SECRETS_KEY 與 MFA_CHALLENGE_SECRET。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Zekra，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.fadymondy%2Fzekra/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "zekra": {
      "type": "http",
      "url": "https://mcp.zekra.dev/"
    }
  }
}

README

[Zekra]

Zekra — ذكرى

Shared long-term memory for AI agents. What one session learns, the next one already knows.

Zekra is a memory service that any agent (Claude Code, Codex, Gemini, Cursor, your own fleet) reaches over MCP. It stores what agents and people learn, deduplicates and updates it on write, and returns the right memory on recall, with citations.

[Built with ToGO] [ToGO on GitHub] [CI] [License: AGPL-3.0] [Discord] [GitHub stars]

Website · Docs · Discord · Discussions · Issues

[Zekra console: memories land in a graph, then a plain-words recall returns the right memory with its source note]

Features

  • Retain / recall — hybrid retrieval: dense vectors + multilingual BM25 fused with RRF, a salience nudge, reranking, and 1-hop entity expansion. A write-decision step (ADD / UPDATE / INVALIDATE / NOOP) updates contradicted facts instead of duplicating them. Nothing is hard-deleted: forget soft-invalidates and history stays queryable.
  • Many brains — one namespace per project or team, with per-agent grants and access tokens (cbt_…) enforced server-side.
  • Knowledge graph — entities and typed relations extracted from memories, with traverse / neighbors / path / ontology queries and a graph "spine".
  • Data sources — connectors (text, markdown, crawler, github, sql, webhook) pull external content, chunk it and retain it through the same write pipeline. See Data sources.
  • Chat with a brain — a tool-calling agent that uses the brain's own recall / search / graph / retain as tools and answers with citations and an auditable trace.
  • Knowledge gaps, secrets vault, activity log — plus a web console to manage it all.
  • Tiers — Redis L1 working-memory cache, hot Postgres tier, object-store cold tier.

Quick start

Hosted

Sign up at app.zekra.dev, create a brain and mint a token, then connect your agent:

bash
curl -fsSL https://app.zekra.dev/install.sh | sh     # installs the `zekra` CLIzekra auth login --token <cbt_…>zekra mcp:install claude-code                        # or claude-desktop | codex | gemini | cursor

The CLI lives in fadymondy/zekra-cli.

Self-host with Docker Compose

Requirements: Docker with Compose v2, and about 6 GB of disk for the embedding and reranker models.

bash
git clone https://github.com/fadymondy/zekra.git && cd zekracp .env.selfhost.example .env.selfhost# fill in POSTGRES_PASSWORD, AUTH_SECRET, ZEKRA_SECRETS_KEY and MFA_CHALLENGE_SECRET# (generate each with: openssl rand -hex 32), and your email in ADMIN_EMAILSdocker compose -f docker-compose.selfhost.yml --env-file .env.selfhost up -d --build

Open http://localhost:3020 and register. The stack runs Postgres 17 with VectorChord, a one-shot schema job, the Go API, the Next.js console and two CPU TEI servers (embeddings and reranking), which download their models on first start. Then mint a token under Admin → Tokens and run zekra auth login --url http://localhost:3020 --token cbt_….

For a public deployment, put a TLS reverse proxy in front and set APP_URL. Every setting is covered in docs/self-hosting.md and DEPLOY.md.

MCP tools

MCP tools include memory_retain, memory_recall, memory_get, memory_forget, memory_share, memory_edit, graph_*, memory_gaps, brain_* (list, grants, tokens, chat), secret_* and datasource_*. Full reference: MCP server · contracts: contracts/tools.md.

Architecture

  Claude Code · Codex · Cursor · your agents        web console · mobile · desktop · extension          │ MCP (Streamable HTTP or stdio)                    │ REST / GraphQL / SSE          └───────────────────────┬───────────────────────────┘                 ┌────────────────▼─────────────────────────────────────┐                 │ Go API (ToGO: plugins on a microkernel)               │                 │  brain plugin: retain → write-decision (ADD/UPDATE/    │                 │  INVALIDATE/NOOP) · recall: vectors + BM25 → RRF →    │                 │  rerank → 1-hop graph · graph · data sources · chat   │                 └──────┬──────────────────┬─────────────────┬───────────┘                        │                  │                 │           ┌────────────▼──────┐   ┌───────▼──────┐   ┌──────▼─────────┐           │ Postgres + vchord │   │ TEI embed /  │   │ Redis L1 ·     │           │ BM25 · partman    │   │ rerank       │   │ Cognee (opt.)  │           └───────────────────┘   └──────────────┘   └────────────────┘

Zekra is a ToGO app built from plugins:

PartWhereRole
brainplugins/brain (module github.com/togo-framework/brain)the memory organ: schema, retain/recall, graph, connectors, chat, REST
brain-teiplugins/brain-teiembeddings + rerank via TEI (Qwen3-Embedding-0.6B, bge-reranker-v2-m3)
brain-cogneeplugins/brain-cogneeentity / graph extraction engine (Cognee)
cache-redisplugins/cache-redisL1 cache
harnesscmd/api, cmd/migrate, internal/, web/the app: API server, migrations, React console
zekra-mcpcmd/zekra-mcpstdio MCP server — thin adapter over the REST API
zekractlcmd/zekractlops CLI: inspect DB, apply schema/BM25, BM25 smoke test, graph mirror

Design: SPEC.md · decisions: contracts/internal/decisions.md · deploy: DEPLOY.md.

Built on ToGO

Zekra is built on ToGO (GitHub), the open-source, API-first framework for Go + sqlc + Atlas + GraphQL/OpenAPI + Next.js with a Laravel-style CLI. The kernel is small and everything else is a plugin; these are the pieces Zekra uses:

ToGO pieceWhat it does in Zekra
KernelConfig, the hook/event bus, the plugin registry and server bootstrap
CLItogo generate (sqlc → gqlgen → Atlas → OpenAPI), togo serve, togo install
authSign-in, JWT sessions, roles and API tokens; MFA, passkeys and OAuth come from the auth plugin family
db-postgresThe Postgres driver under the brain schema
queue · cache · storage · mailIngestion jobs, caching, media and transactional email
Plugin modelThe memory organ itself ships as ToGO plugins: brain, brain-tei, brain-cognee, cache-redis

Want the same foundation for your own app? Run go install github.com/togo-framework/cli@latest && togo new myapp, then read the ToGO docs and browse the plugin marketplace.

Read the case study: MCP Server in Go: How Zekra Is Built on ToGO Plugins.

Documentation

Full docs at https://zekra.dev/en/docs (source: docs/):

Contributing

Bug reports, docs and code contributions are all welcome. Start with CONTRIBUTING.md, which covers setup, conventions and the DCO sign-off. Then look for a good first issue. AI coding agents should start with AGENTS.md.

Translations

[Translation status]

Zekra is translated on Hosted Weblate, help us translate it into your language: https://hosted.weblate.org/projects/zekra/. See CONTRIBUTING.md for how it works.

Community

Please follow the Code of Conduct.

Sponsor

Zekra is built on ToGO, the open-source Go + React framework that powers this whole family of apps. The best way to support Zekra is to sponsor ToGO: every sponsorship goes into the framework and the apps built on it.

Sponsor ToGO →

[Sponsor ToGO] [GitHub Sponsors] [Buy Me a Coffee]

License

Copyright (C) 2026 Fady Mondy. Zekra is free software, licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). If you run a modified version as a network service, you must offer its source to your users. Third-party components keep their own licenses.

Commercial licensing available: for a license without the AGPL obligations, contact [email protected].

More open source from the same author

  • TomatoPHP: 60+ open-source FilamentPHP plugins for Laravel
  • Laravilt: Laravel admin panels rendered with Inertia on Vue 3 or React 19
  • ToGO: the Laravel-style workflow for Go + React apps, with a plugin marketplace

Built by Fady Mondy.

來源：README.md，提交 58340a0

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Oct 11, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分