AKB MCP
AKB is a PostgreSQL-native knowledge base for agents: documents, tables and files in vaults, search and relations over MCP.
- 168 ★ on the repository
- Last commit
Broad access
Why this level
- Tools create, change and delete vault documents, tables and files.
- `akb_sql` runs SQL inside the user vault under their permissions.
Install
- Works in
Manual install
/plugin marketplace add dnotitia/akbPlugins akb-wiki, akb-sessions and akb-claude-code; a deployed AKB is required.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Tools create, change and delete vault documents, tables and files.
- `akb_sql` runs SQL inside the user vault under their permissions.
This is third-party code. Review the repository files before installing.
What it does
AKB (Agent Knowledge Base) stores organizational memory for AI agents. Agents read and write documents, tables and files over MCP, search combines semantic and keyword methods, and a URI graph links materials. The system positions itself as a replacement for Confluence or Notion for Claude Code, Cursor, Windsurf and other clients. Tools: `akb_put`, `akb_get`, `akb_update`, `akb_delete` (documents with revisions and indexing), `akb_search`, `akb_browse`, `akb_relations`, `akb_list_vaults`, `akb_create_vault`, `akb_put_file`, `akb_sql`. Vault isolation relies on PostgreSQL permissions: each user has a role, each vault has three group roles, and `akb_sql` runs the user query inside a transaction under their rights. Access uses a personal token (PAT) to `/mcp/`, the `akb-mcp` stdio proxy, or OAuth when Keycloak is deployed. For Claude Code and Codex there are plugins: `akb-wiki` (ingesting sources into the vault and answers with citations), `akb-sessions` (coding session reports) and `akb-claude-code` (hooks that pull memory at session start and write a recap at the end).
Who it is for. Teams deploying shared memory for agents in their own infrastructure: engineering wikis, session notes, decisions and project vocabularies.
Good fit when
- The agent reads decisions and preferences recorded in past sessions before working.
- Sources (a PR, a release, a Confluence page, a Jira issue) become a structured vault document.
- Wiki questions get an answer with citations from vault documents.
- Notes about a coding session are saved together with tasks, ideas and decisions.
Not a fit when
- A ready cloud service is needed: AKB is deployed by you with Docker Compose or Kubernetes.
- There are no resources for PostgreSQL with pgvector, MinIO and a worker: the stack has several services.
- A permissive license is needed: AKB is released under BUSL-1.1.
Example request
Find the task queue decisions in the AKB vault, cite the documents and add a new document with the outcome of today discussion.MCP
- Transport
- http, stdio
- Authentication
- API key
Limitations
The license is BUSL-1.1 (Business Source License), source-available with usage terms. The recommended stack includes PostgreSQL with pgvector, MinIO, an API, a separate worker and a frontend, requires Docker Compose 2.24.4 or newer and a fresh never-used database. Dense search needs an OpenAI-compatible embeddings endpoint, without it only lexical BM25 remains. Existing installations are upgraded through a separate configuration preservation procedure. The public demo is wiped and re-seeded weekly with no privacy guarantees.
How to disable. Remove the akb entry from the client configuration and revoke the personal token in AKB. Plugins are removed with `/plugin` in Claude Code.
FAQ
How do I connect AKB to Claude Code?
The basic path uses a personal token and `akb-mcp` (npm). If OAuth through Keycloak is deployed, `mcp add --transport http` and `mcp login` work.
Are there plugins for agents?
Yes, for Claude Code and Codex: `/plugin marketplace add dnotitia/akb` and `codex plugin marketplace add dnotitia/akb`.
What search quality do the authors claim?
Recall@5 of 98.4 percent on LongMemEval-S of 500 questions with no reranker, the method and a reproducible run are in `eval/longmemeval/`.
Can I try it without installing?
Yes, there is a public demo, but it is wiped weekly and unsuitable for real data.
Which MCP protocol versions are supported?
The modern 2026-07-28 (stateless) and the earlier 2024-11-05, 2025-03-26, 2025-06-18 and 2025-11-25.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server and REST API with shared memory for Claude Code, Codex and Gemini: Obsidian notes, sessions, bug fixes, lean search.
akm indexes skills, commands, agents and notes in one place and hands an agent only what a task needs
Local memory for agents: decisions from browser chats reach Claude Code, Cursor and Windsurf through MCP
Knowledge-graph memory for agents: Claude Code and Codex plugins, an MCP server and a Python library
A local MCP memory server for coding agents: decisions, errors and facts stay on your machine, with semantic and graph recall
Shared memory for fleets of AI agents with access scopes, an audit trail and a knowledge graph: an MCP server, Docker and a cloud
README in short
The README explains AKB as organizational memory for agents, compatible clients, supported MCP protocol versions, plugins for Claude Code and Codex, the demo, search quality tests and design principles, then covers Docker Compose deployment and the tool reference.