BrainOS — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер BrainOS для Claude Code сохраняет решения, блокеры и планы между сессиями агентов. Система сверяет новые действия с базой уже согласованных архитектурных выборов.
MIT ★ 6 обновлён 2026-11-17
claude mcp add brain-os -- npx -y brain-osЧто делает BrainOS
Сервер фиксирует операционный контекст проекта в каталоге .brain/. Вместо сырых логов диалога инструмент сохраняет структуру: записи о задачах, отклонённые альтернативы к решениям, повторяющиеся блокеры и приоритеты текущей работы. Функция decision_check предупреждает модель, если свежая идея противоречит прежним договорённостям.
Для инициализации в проекте запускают команду npx brain-os init либо запрашивают настройку прямо в чате через инструмент brain_setup. Процесс создаёт правила для агентов в файле AGENTS.md и добавляет слэш-команды вроде /brain:focus и /brain:decide. Дополнительный чекер operational_state_check считывает текущую ветку, коммит Git и версию пакета без внесения правок в файлы.
Для запуска требуется среда Node.js 20 или новее. Базовые функции фиксации планов и сущностей работают локально без сторонних сервисов, но вызов semantic_recall потребует установки пакета openai и ключа OPENAI_API_KEY.
Какие задачи решает
- сохранять архитектурные решения и отклонённые альтернативы между диалогами
- проверять новые предложения агента на конфликты с прошлыми решениями
- отслеживать застрявшие задачи и повторяющиеся блокеры в проекте
- сверять состояние репозитория Git и версий пакетов без изменения файлов
Примеры запросов агенту
- Настрой Brain OS в этом репозитории через brain_setup
- /brain:decide Выбрать SQLite вместо Postgres для локального хранилища
- Проверь предложение изменить схему данных через decision_check
Как установить BrainOS
Командой платформы
claude mcp add brain-os -- npx -y brain-osКомандой платформы
codex mcp add brainos -- npx -y brain-osФайл настроек
{
"mcpServers": {
"brainos": {
"command": "npx",
"args": [
"-y",
"brain-os"
]
}
}
}Файл настроек
{
"servers": {
"brainos": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"brain-os"
]
}
}
}Командой платформы
gemini mcp add brainos npx -y brain-osПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о BrainOS
Как установить BrainOS в Claude Code?
Для подключения выполните команду claude mcp add brain-os -- npx -y brain-os.
Что делает BrainOS?
Сервер хранит состояние проекта в папке .brain/, записывает принятые решения с отклонёнными альтернативами и проверяет новые предложения кода на конфликты с прошлыми договорённостями.
Что нужно для работы BrainOS?
Требуется среда Node.js версии 20 или новее. Базовые функции не требуют внешних сервисов, а для инструмента семантического поиска semantic_recall нужен пакет openai и переменная OPENAI_API_KEY.