Octobrain — MCP-сервер для Claude Code: долговременная память
Хранит решения, заметки и выводы между сессиями и достаёт их семантическим поиском. Пригодится, когда агент каждый раз начинает с чистого листа.
claude mcp add octobrain -- npx -y @muvon/octobrainЧто делает Octobrain
Octobrain даёт ассистенту память, которая переживает закрытие чата. Записи складываются с заголовком, типом и тегами, а поиск идёт по смыслу, а не по точному совпадению слов. Связанные записи цепляются друг к другу автоматически, как в Zettelkasten, и по ним можно ходить графом.
Внутри — CLI на Rust и MCP-сервер поверх той же базы. Через octobrain memory memorize запись сохраняется, octobrain memory remember ищет, octobrain memory relate и octobrain memory graph строят связи между записями. Отдельная ветка knowledge индексирует ссылки и файлы (.md, .pdf, .docx, .txt, .html) и ищет по ним. Есть команды обслуживания: memory maintenance для пересборки индексов и memory cleanup для старых записей.
По умолчанию сборка тянет локальные эмбеддинги через FastEmbed и HuggingFace, ключи не нужны. Векторы от Voyage, OpenAI, Google или Jina включаются сборкой без дефолтных фич — тогда без переменной вроде OPENAI_API_KEY поиск не заработает. Для установки из исходников нужен Rust 1.95 и новее.
Какие задачи решает
- вернуть контекст проекта в новую сессию без повторного пересказа
- найти решение по смыслу, а не по точному слову в заголовке
- связать записи о зависимостях между модулями в граф
- проиндексировать документацию библиотеки и искать по ней
- почистить устаревшие заметки перед началом новой задачи
Примеры запросов агенту
- Запомни: для CRUD используем REST, для сложных выборок GraphQL. Сохрани как архитектурное решение с тегом api
- Найди в памяти, как мы решали работу с фоновыми задачами в tokio
- Проиндексируй
./docs/architecture.mdи найди там раздел про авторизацию
Как установить Octobrain
Командой платформы
claude mcp add octobrain -- npx -y @muvon/octobrainКомандой платформы
codex mcp add octobrain -- npx -y @muvon/octobrainФайл настроек
{
"mcpServers": {
"octobrain": {
"command": "npx",
"args": [
"-y",
"@muvon/octobrain"
]
}
}
}Файл настроек
{
"servers": {
"octobrain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octobrain"
]
}
}
}Командой платформы
gemini mcp add octobrain npx -y @muvon/octobrainПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Octobrain
Как установить Octobrain в Claude Code?
Одной командой: claude mcp add octobrain -- npx -y @muvon/octobrain. После этого сервер поднимается при старте сессии.
Что делает Octobrain?
Держит базу записей с типами и тегами, ищет по ним семантически и связывает похожие записи в граф. Ещё индексирует локальные файлы и веб-страницы для поиска по содержимому.
Нужны ли ключи API для работы?
При обычной сборке нет: эмбеддинги считаются локально через FastEmbed и HuggingFace. Ключи понадобятся, только если собирать с провайдерами Voyage, OpenAI, Google или Jina.
