knowledge-base-server MCP
MCP-сервер и REST API с общей памятью для Claude Code, Codex и Gemini: заметки Obsidian, сессии и багфиксы, экономный поиск.
- 190 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает ваше хранилище заметок, пишет в него новые заметки и открывает панель с паролем на порту 3838.
- Для классификации тексты заметок отправляются во внешний API моделей.
Установка
- Работает в
Ручная установка
git clone https://github.com/willynikes2/knowledge-base-server.gitПервая команда раздела Install. Затем `npm install`, `npm link` и `kb setup`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает ваше хранилище заметок, пишет в него новые заметки и открывает панель с паролем на порту 3838.
- Для классификации тексты заметок отправляются во внешний API моделей.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
knowledge-base-server собирает знания в одну базу SQLite с полнотекстовым и семантическим поиском и отдает их агентам через MCP и REST. Источники: хранилище Obsidian с двусторонней синхронизацией, расшифровки YouTube, веб-статьи, терминальные сессии и записи об исправленных ошибках. Инструмент `kb_classify` размечает необработанные заметки, `kb_promote` превращает их в уроки и решения, а `kb_synthesize` ищет общие закономерности. Память делится на горячую, теплую и холодную: активный контекст отдается первым, сырые материалы только по запросу. Инструмент `kb_context` выдает краткую сводку и экономит больше 90 процентов токенов. В локальном режиме есть шина сообщений между моделями и журнал ошибок, а `kb_safety_check` сверяет опасное действие с историей базы.
Для кого. Тем, кто работает с несколькими агентами и хранит заметки в Obsidian, и хочет, чтобы агенты помнили прошлые решения и разборы ошибок.
Подходит, если
- Агент заново узнает, как вчера починили авторизацию, из записи о баге.
- Нужно подать в Claude Code краткую сводку по проекту без загрузки всех заметок.
- Расшифровку YouTube-ролика и веб-статью сохраняют в базу и ищут позже.
- Claude Code, Codex и Gemini CLI используют одну базу знаний.
- Перед удалением данных сверяют команду с историей ошибок.
Не подходит, если
- Не хочется держать свой сервер: у автора есть платная облачная версия Memstalker.
- Нужна готовая облачная синхронизация между устройствами без настройки.
- Заметки содержат данные, которые нельзя передавать модели для классификации.
Пример запроса к агенту
Найди в базе знаний, как мы чинили авторизацию, и покажи краткий контекст вместо полных заметок.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
KB_PASSWORDобязательная, секрет- Пароль панели управления при первом запуске
OBSIDIAN_VAULT_PATH- Путь к хранилищу Obsidian для синхронизации
Ограничения
Сервер запускается из клона репозитория: `git clone`, `npm install` и `npm link`, потом `kb setup`. Нужен Node.js 20 и новее. Для классификации и синтеза используются модели Anthropic (по умолчанию Haiku и Sonnet), поэтому тексты заметок уходят во внешний API. Пароль панели задается переменной `KB_PASSWORD`, а удаленный доступ с ключами и OAuth требует отдельной настройки. У автора есть и платный хостинг Memstalker. Пакет в реестре npm под этим именем существует, но принадлежит ли он этому проекту, неизвестно: ставьте из клона.
Как отключить. Удалите запись MCP из конфигурации агента, остановите сервис `kb-server` и удалите клон репозитория. Базу SQLite и хранилище Obsidian удаляйте отдельно.
Частые вопросы
Как установить knowledge-base-server?
Выполните `git clone`, `npm install` и `npm link`, затем `kb setup`: мастер определит окружение и спросит, какие агенты вы используете. Занимает около минуты.
Как подключить MCP к агентам?
Команда `kb register` регистрирует MCP в Claude, Codex и Gemini, а `kb register --agents=claude,codex` только в части из них.
Сколько инструментов у сервера?
Шестнадцать основных по stdio и HTTP, плюс локальные инструменты шины сообщений и журнала ошибок только для stdio.
Как экономятся токены?
Инструмент `kb_context` отдает краткую сводку вместо полного текста, а `kb_read` читает документ целиком только при необходимости.
Работает ли с ChatGPT?
Да, через REST API с пользовательскими GPT или через удаленный MCP с OAuth. Для этого нужна настройка ключей и адреса сервера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыAKB — база знаний для агентов на PostgreSQL: документы, таблицы и файлы в хранилищах, поиск и связи через MCP.
Локальный MCP-сервер памяти для агентов: решения, ошибки и факты хранятся на вашей машине, поиск идет по смыслу и графу знаний
Membase хранит одну общую память для ИИ-агентов, и Claude Code, Cursor и Codex читают ее через MCP, SDK или команду membase
MCP-сервер хранит доменные знания в графе: агент ищет сущности и связи, а при необходимости сам добавляет и обновляет их.
MCP-сервер долгой памяти для агентов: атомарные заметки, поиск по смыслу и граф связей между ними на SQLite или PostgreSQL
BrainAPI превращает текст в граф знаний на вашем сервере и отдает агентам через MCP, REST и консоль с ответами по цепочке фактов
Коротко о README
Документация подает проект как конвейер знаний из семи слоев: захват, классификация, повышение, синтез, три уровня памяти, экономный поиск и цикл самообучения. Отдельные разделы описывают подключение разных агентов и загрузку источников.