robrain — MCP-сервер для Claude Code: что делает и как установить
Сохраняет инженерные решения и отклонённые варианты в Postgres. Предупреждает ИИ-агента до того, как тот снова предложит забракованный подход.
claude mcp add --env PERCEPTION_API_URL=<PERCEPTION_API_URL> --env PERCEPTION_API_KEY=<PERCEPTION_API_KEY> --transport stdio robrain -- npx -y robrainЧто делает robrain
Инструмент анализирует реплики в сессиях редактора и извлекает принятые решения в базу данных. В отличие от стандартных журналов контекста, структура сохраняет отклонённые альтернативы в явном поле rejected[]. Когда агент в новой сессии пытается повторить забракованный путь, сервер вовремя выдаёт записанные аргументы против такой идеи.
Архитектура состоит из двух ступеней: модуль Perception извлекает решения, а Synthesis выполняет пакетную сверку. Команда npx robrain synth ищет противоречия по всему накопленному корпусу. Историю решений по отдельному файлу можно запросить через npx robrain explain <path>.
Без запущенного сервиса Perception и заданных переменных PERCEPTION_API_KEY и PERCEPTION_API_URL сервер не сможет отвечать на вызовы. Для локальной работы потребуется Docker с контейнером Postgres и ключи API для выбранных провайдеров (по умолчанию используются Anthropic и OpenAI).
Какие задачи решает
- остановить повторное предложение отклонённых библиотек или архитектурных ходов
- передавать контекст принятых решений между разными редакторами команды
- находить смысловые противоречия в накопленной базе через команду
synth - проверять историю инженерных изменений конкретного файла через
explain
Примеры запросов агенту
- Почему мы отказались от Express в пользу Hono в этом сервисе?
- Проверь по базе решений, можно ли менять схему этой таблицы.
- Объясни, какие альтернативы мы уже забраковали для модуля авторизации.
Как установить robrain
Командой платформы
claude mcp add --env PERCEPTION_API_URL=<PERCEPTION_API_URL> --env PERCEPTION_API_KEY=<PERCEPTION_API_KEY> --transport stdio robrain -- npx -y robrainВместо <…> подставьте свои значения
Командой платформы
codex mcp add robrain --env PERCEPTION_API_URL=<PERCEPTION_API_URL> --env PERCEPTION_API_KEY=<PERCEPTION_API_KEY> -- npx -y robrainВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"robrain": {
"command": "npx",
"args": [
"-y",
"robrain"
],
"env": {
"PERCEPTION_API_URL": "<PERCEPTION_API_URL>",
"PERCEPTION_API_KEY": "<PERCEPTION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"robrain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"robrain"
],
"env": {
"PERCEPTION_API_URL": "<PERCEPTION_API_URL>",
"PERCEPTION_API_KEY": "<PERCEPTION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PERCEPTION_API_URL=<PERCEPTION_API_URL> -e PERCEPTION_API_KEY=<PERCEPTION_API_KEY> robrain npx -y robrainВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о robrain
Как установить robrain в Claude Code?
Выполните в терминале команду `claude mcp add --env PERCEPTION_API_URL=<PERCEPTION_API_URL> --env PERCEPTION_API_KEY=<PERCEPTION_API_KEY> --transport stdio robrain -- npx -y robrain`. Подставьте адрес работающего сервиса Perception и ключ доступа.
Что делает robrain?
Сервер сохраняет принятые инженерные решения и отвергнутые варианты в Postgres. Он сообщает агенту об аргументах команды, если тот пытается вернуть отклонённый подход.
Что требуется для запуска локального варианта?
Нужно поднять контейнеры через команду npx robrain@latest up, которая запустит Postgres и образ Perception. Также понадобятся ключи API провайдеров моделей (по умолчанию Anthropic и OpenAI).
