BrainAPI MCP
BrainAPI превращает текст в граф знаний на вашем сервере и отдает агентам через MCP, REST и консоль с ответами по цепочке фактов
- 551 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Принимает документы и содержимое страниц сайтов в базу данных и отправляет текст выбранным ИИ-моделям, облачным или локальным
- MCP-сервер дает агенту чтение и запись в память, а токен `BRAINPAT_TOKEN` открывает и консоль, и API
- Установщик клонирует репозиторий, ставит зависимости и запускает Docker-сервисы на вашей машине
Установка
- Работает в
Ручная установка
npm install -g brainapi-tuiЗатем brainapi init и brainapi start: команды клонируют проект в ~/.brainapi, готовят окружение и запускают сервисы.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Принимает документы и содержимое страниц сайтов в базу данных и отправляет текст выбранным ИИ-моделям, облачным или локальным
- MCP-сервер дает агенту чтение и запись в память, а токен `BRAINPAT_TOKEN` открывает и консоль, и API
- Установщик клонирует репозиторий, ставит зависимости и запускает Docker-сервисы на вашей машине
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BrainAPI — самостоятельно разворачиваемый слой памяти для ИИ-агентов. Документы, заметки и события отправляются в него через REST, группа агентов разбирает текст и строит граф. Агент Scout находит сущности, Observations записывает заметки о фактах, Architect связывает сущности в события вида «кто что сделал с кем и в каком контексте», Janitor проверяет связи и ищет дубликаты. Граф только дополняется, ничего не удаляется, поэтому история сохраняется целиком. Запросы к графу возвращают тройки фактов, фрагменты текста и исторический контекст с путем, по которому получен ответ. Конечная точка `/retrieve/context` отдает релевантный контекст к фразе, `/retrieve/search` включается флагом `SEARCH_ENABLED=true` и дает ранжированные фрагменты. MCP-сервер слушает порт 8001 по адресу /mcp, поэтому любой агент с поддержкой MCP читает и пишет в память. Плагины могут добавлять свои MCP-инструменты. Для Claude Desktop в репозитории есть мост между stdio и Streamable HTTP на Rust. Установка идет через npm-пакет brainapi-tui: команды `brainapi init` и `brainapi start` клонируют проект, готовят окружение и запускают API, MCP, воркер Celery и веб-консоль.
Для кого. Разработчикам агентов и тем, кому нужна долговременная память с проверяемым источником каждого факта, развернутая на своей инфраструктуре.
Подходит, если
- Агент должен отвечать на многошаговые вопросы по накопленным документам и показывать цепочку фактов
- Память агентов нужно держать на своем сервере, с Docker, Ollama или облачными моделями на выбор
- Данные поступают потоком событий, и важно хранить историю изменений без перезаписи
- В память нужно загружать страницы сайтов: для этого BrainAPI обходит адрес через Lumen Crawler и сохраняет факты
Не подходит, если
- Нужна простая заметочная память без сервера: полный стек с базами и воркером слишком тяжел
- Лицензия Business Source 1.1 вас не устраивает: код открыт для чтения, но по критериям OSI лицензия не открытая
- Нужен один вызов без развертывания: у проекта есть облачная версия, но этот репозиторий рассчитан на запуск у себя
Пример запроса к агенту
Подключись к MCP-серверу BrainAPI и найди в памяти, кто организовал встречи об ИИ в Лондоне в первом квартале, с цепочкой фактовMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
BRAINPAT_TOKENобязательная, секрет- Токен доступа, который создается при установке и открывает вход в консоль и MCP-сервер
LUMEN_CRAWLER_KEYсекрет- Ключ Lumen Crawler для загрузки страниц сайтов в память
Ограничения
- Лицензия Business Source License 1.1 от Lumen Platforms: исходный код доступен, но это не открытая лицензия в смысле OSI.
- Для работы нужны Docker или отдельные базы, модели локально через Ollama либо ключи облачных провайдеров, а также воркер Celery.
- Поиск по фрагментам выключен по умолчанию, BM25 требует PostgreSQL в роли хранилища данных.
- MCP-сервер защищен токеном `BRAINPAT_TOKEN`, который создается при установке. Для Claude Desktop нужен отдельный собранный на Rust мост.
Как отключить. Остановите стек сочетанием Ctrl-C в окне, где запущена команда `brainapi start`, или командой make stop-all в режиме разработки. Данные и установка лежат в папке ~/.brainapi, ее удаляют вручную. Из конфигурации агента уберите запись MCP-сервера.
Частые вопросы
Как подключить BrainAPI к Claude Code как MCP-сервер?
После `brainapi start` MCP-сервер доступен по адресу http://localhost:8001/mcp. Добавьте его в конфигурацию агента как HTTP-сервер и передайте токен `BRAINPAT_TOKEN` в заголовке авторизации. Для Claude Desktop соберите мост mcp-stdio-http-bridge.
Чем BrainAPI отличается от обычного векторного поиска?
Он строит граф событий и возвращает тройки фактов с путем, по которому получен ответ. Векторный поиск отдает только похожие фрагменты. Поиск по фрагментам в BrainAPI тоже есть, но включается отдельно флагом `SEARCH_ENABLED=true`.
Что значит append-only в BrainAPI?
Из графа ничего не удаляется. Новое действие добавляется отдельным узлом события, и старые данные остаются на месте, поэтому можно восстановить, как менялись факты.
Что такое режимы accurate и lightweight?
В режиме accurate по умолчанию работает весь набор агентов с проверкой Janitor. В режиме lightweight извлекаются только самые важные сущности без тяжелой проверки. Переключают флагом `--pipeline lightweight` или переменной `PIPELINE_MODE`.
Какая у BrainAPI лицензия?
Business Source License 1.1 от Lumen Platforms. Код открыт для чтения, но ограничения коммерческого использования определяет текст лицензии, его нужно прочитать до внедрения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и API общей памяти для нескольких агентов: факты, решения и события хранятся в одной базе с поиском по смыслу.
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
Локальная память для агентов: решения из чатов в браузере попадают в Claude Code, Cursor и Windsurf через MCP
Общая память для группы ИИ-агентов с областями доступа, аудитом и графом знаний: MCP-сервер, Docker и облако
Память для агентов по MCP: пять инструментов, локальный файл SQLite и слои, как в человеческой памяти, без аккаунта
Membase хранит одну общую память для ИИ-агентов, и Claude Code, Cursor и Codex читают ее через MCP, SDK или команду membase
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| BrainAPI (эта карточка) | да | API-ключ | 551 | |
| MCP Memory Service | нет | не нужна | 2 117 | память-хранилище заметок и векторов, BrainAPI строит граф событий с путем к ответу |
| agent-memory | нет | 4 315 | память без графа событий и без проверки фактов отдельным агентом |
Коротко о README
README объясняет идею событийного графа на примере одной фразы, затем дает быстрый старт через brainapi-tui и режим разработки через make. Дальше описаны веб-консоль, конвейер из четырех агентов, режимы accurate и lightweight, конечные точки запросов и система плагинов с публичным реестром.