AKB MCP
AKB — база знаний для агентов на PostgreSQL: документы, таблицы и файлы в хранилищах, поиск и связи через MCP.
- 168 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструменты создают, меняют и удаляют документы, таблицы и файлы хранилищ.
- `akb_sql` выполняет SQL внутри хранилища пользователя под его правами.
Установка
- Работает в
Ручная установка
/plugin marketplace add dnotitia/akbПлагины akb-wiki, akb-sessions и akb-claude-code; нужен развернутый AKB.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты создают, меняют и удаляют документы, таблицы и файлы хранилищ.
- `akb_sql` выполняет SQL внутри хранилища пользователя под его правами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AKB (Agent Knowledge Base) хранит организационную память для ИИ-агентов. Агенты читают и пишут документы, таблицы и файлы по MCP, поиск объединяет семантический и ключевой способы, а граф URI связывает материалы. Система позиционируется как замена Confluence или Notion для Claude Code, Cursor, Windsurf и других клиентов. Инструменты: `akb_put`, `akb_get`, `akb_update`, `akb_delete` (документы с ревизиями и индексацией), `akb_search`, `akb_browse`, `akb_relations`, `akb_list_vaults`, `akb_create_vault`, `akb_put_file`, `akb_sql`. Изоляция хранилищ опирается на права PostgreSQL: у каждого пользователя своя роль, у каждого хранилища три групповые роли, а `akb_sql` выполняет запрос пользователя внутри транзакции под его правами. Доступ идет по личному токену (PAT) к `/mcp/`, либо через прокси `akb-mcp` по stdio, либо по OAuth, если развернут Keycloak. Для Claude Code и Codex есть плагины: `akb-wiki` (загрузка источников в хранилище и ответы с цитатами), `akb-sessions` (отчеты о сессиях кодинга) и `akb-claude-code` (хуки, которые подтягивают память в начале сессии и пишут итог в конце).
Для кого. Командам, которые развертывают общую память для агентов у себя: инженерные вики, заметки сессий, решения и словари проекта.
Подходит, если
- Агент перед работой читает решения и предпочтения, записанные в прошлых сессиях.
- Источники (PR, релиз, страница Confluence, задача Jira) превращают в структурированный документ хранилища.
- Вопросы к вики получают ответ с цитатами из документов хранилища.
- Заметки о сессии кодинга сохраняют вместе с задачами, идеями и решениями.
Не подходит, если
- Нужен готовый облачный сервис: AKB разворачивают сами через Docker Compose или Kubernetes.
- Нет ресурсов на PostgreSQL с pgvector, MinIO и воркер: стек состоит из нескольких сервисов.
- Нужна свободная лицензия: AKB выпущен под BUSL-1.1.
Пример запроса к агенту
Найди в хранилище AKB решения по очереди задач, процитируй документы и добавь новый документ с итогом сегодняшнего обсуждения.MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Ограничения
Лицензия BUSL-1.1 (Business Source License), у кода исходного доступа есть условия использования. Рекомендуемый стек включает PostgreSQL с pgvector, MinIO, API, отдельный воркер и фронтенд, нужен Docker Compose 2.24.4 или новее и новая база без прежнего использования. Плотный поиск требует OpenAI-совместимого эндпоинта эмбеддингов, без него остается лексический BM25. Существующие установки обновляют по отдельной процедуре сохранения конфигурации. Общедоступная демо стирается и засевается раз в неделю, без гарантий приватности.
Как отключить. Удалите запись akb из конфигурации клиента и отзовите личный токен в AKB. Плагины убираются командой `/plugin` в Claude Code.
Частые вопросы
Как подключить AKB к Claude Code?
Для базового пути используйте личный токен и `akb-mcp` (npm). Если развернут OAuth через Keycloak, подходит `mcp add --transport http` и `mcp login`.
Есть ли плагины для агентов?
Да, для Claude Code и Codex: `/plugin marketplace add dnotitia/akb` и `codex plugin marketplace add dnotitia/akb`.
Какую точность поиска заявляют авторы?
Recall@5 98,4 процента на LongMemEval-S из 500 вопросов без реранкера, методика и воспроизводимый прогон лежат в `eval/longmemeval/`.
Можно ли попробовать без установки?
Да, есть общедоступная демо-версия, но она стирается раз в неделю и не годится для настоящих данных.
Какие версии протокола MCP поддерживаются?
Современная 2026-07-28 (без сессий) и прежние 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и REST API с общей памятью для Claude Code, Codex и Gemini: заметки Obsidian, сессии и багфиксы, экономный поиск.
akm индексирует скиллы, команды, агентов и заметки в одном месте и отдает агенту только нужное под задачу
Локальная память для агентов: решения из чатов в браузере попадают в Claude Code, Cursor и Windsurf через MCP
Память для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Локальный MCP-сервер памяти для агентов: решения, ошибки и факты хранятся на вашей машине, поиск идет по смыслу и графу знаний
Общая память для группы ИИ-агентов с областями доступа, аудитом и графом знаний: MCP-сервер, Docker и облако
Коротко о README
README объясняет назначение AKB как памяти организации для агентов, совместимые клиенты, поддерживаемые версии протокола MCP, плагины для Claude Code и Codex, демо, тесты точности поиска и принципы дизайна, а затем описывает развертывание через Docker Compose и справочник инструментов.