Akb MCP server
Git-backed org memory for AI agents — hybrid search, tables, files & a URI graph over MCP.
160 stars
Reviews
Write oneNobody has reviewed Akb yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Akb tools (3, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
akb_delete_filewrite actionDelete a file from vault storage by its URI.
akb_get_fileDownload a file from vault storage to a local path. Pass the file URI — `akb://{vault}[/coll/{coll_path}]/file/{uuid}` — from akb_browse or akb_put_file.
akb_put_filewrite actionUpload a local file to a vault's file storage (S3-backed). Use for PDFs, images, datasets, or any binary content too large for akb_put. Response includes the canonical `uri` — `akb://{vault}/coll/{collection}/file/{uuid}` when stored under a collection, or `akb://{vault}/file/{uuid}` at the vault root — pass that to akb_get_file / akb_delete_file. MIME type is auto-detected from the filename exten
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
What the publisher says
From the Akb repository's README, as published. We do not edit it. Read it on GitHub
AKB — Agent Knowledge Base
Organizational memory for AI agents. PostgreSQL-native knowledge base served
over the Model Context Protocol (MCP) — agents read and write directly
with hybrid semantic + keyword search, structured tables, files, and a URI
graph. Drop-in alternative to Confluence / Notion for Claude Code, Cursor,
Windsurf, and any MCP-aware agent.
Works with
Any agent client that speaks MCP (Streamable HTTP or stdio):
akb-mcp stdio proxy
- Claude Code — CLI / VS Code / JetBrains
- Claude Desktop — macOS / Windows
- Cursor, Windsurf, Cline, Continue — via the
- Custom agents — direct HTTP POST /mcp/ with a Bearer token
The default flow uses a Personal Access Token. Deployments with the optional MCP OAuth Resource Server path turned on (via Keycloak as the AS — see docs/mcp-clients/web-connectors.md) also accept Claude Code's mcp add --transport http + mcp login flow end-to-end, without a PAT.
MCP protocol compatibility
AKB keeps one tool and authorization core behind two protocol adapters:
The proxy answers either handshake locally and normalizes backend calls to the modern stateless contract when available. Legacy backend sessions are used only during a rolling upgrade when modern discovery is unavailable. A process cannot mix generations, and unsupported revisions or conflicting protocol evidence fail closed before a tool or local-file operation runs.
Plugins
Beyond raw MCP access, AKB ships ready-made agent plugins for Claude Code and Codex that wrap common vault workflows:
commit, Confluence page, or Jira issue) into the vault as a structured document, and answer questions from the vault with grounded, cited synthesis (read-only).
- akb-wiki — ingest a source (local file, web URL, GitHub PR / release /
report plus follow-up tasks, learnings, ideas, and decisions.
- akb-sessions — capture a coding session as structured notes: a session
session to your AKB memory vault, injecting preferences and recent learnings at the start and writing a recap at the end.
- akb-claude-code — a Claude Code lifecycle bridge: hooks anchor each
/plugin marketplace add dnotitia/akb # Claude Code
codex plugin marketplace add dnotitia/akb # CodexInstall details and credentials: plugins/.
Try it live
A public demo runs at akb-demo.agent.seahorse.dnotitia.ai. Browse and search a small fictional-organization knowledge base — product docs, a company handbook, agent session notes, and an engineering wiki, cross-linked by the URI graph — right in your browser, no signup. To wire it into your own agent, sign up with any email (a throwaway address is fine) and point the akb-mcp proxy at https://akb-demo.agent.seahorse.dnotitia.ai/mcp/.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y akb-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add akb -- npx -y akb-mcp
Akb: common questions
- Is Akb MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Akb safety report
- How do I install Akb?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Akb need an API key?
- Yes. The registry entry asks for
AKB_PAT. - Is Akb maintained?
- The last commit was in the last day (2026-09-27). The latest release is v2.0.4.
- What can I use instead of Akb?
- Servers from other publishers that do the same job: Perenna MCP server, Repowise MCP server and Palinode MCP server. Compare all Akb alternatives.
Alternatives to Akb
Same job from other publishers: the closest match first, then the best rated.
- PerennaA lightweight, Git-backed permanent memory for AI agents.not reviewedGrowingB
RepowiseCodebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.not reviewedEstablishedB- PalinodeInspectable, correctable project memory in git-versioned Markdown for AI agents.not reviewedEstablishedC
- SrclightDeep code indexing for AI agents. FTS5 + embeddings + call graphs + git intelligence. Fully local.not reviewedEstablishedA
- ContentrainGit-native content governance for AI agents — 27 deterministic MCP tools over stdio and HTTP.not reviewedEstablishedA
