second-brain MCP — MCP-сервер для Claude Code: база знаний агента
Локальная база знаний в Markdown, которую ИИ-агент читает, пополняет и сам поддерживает в порядке. Пригодится, если заметки и статьи копятся быстрее, чем вы успеваете их разбирать.
claude mcp add mcp-second-brain -- uvx mcp-second-brainЧто делает second-brain MCP
second-brain MCP превращает папку с обычными Markdown-файлами в хранилище, доступное агенту через MCP. Одна команда save_article забирает статью по ссылке или PDF, конвертирует её в Markdown, распознаёт рисунки, строит эмбеддинги и связывает новую заметку с похожими. Поиск работает и по тексту, и по содержимому иллюстраций: search_figures находит нужную панель по всей библиотеке.
Хранилище само себя разгружает. Заметки, к которым давно не обращались, со временем сжимаются, а ранжирование опирается на кривую забывания Эббингауза. В начале сессии get_context подтягивает цели, правила и заметки с высоким рейтингом, чтобы агент не начинал с чистого листа. Индекс пересобирается в любой момент через sync_index, а сами файлы остаются источником правды.
Для работы нужен Python 3.11–3.13 и браузер Chromium для Playwright. Хранилище и шаблоны создаются при первом запуске. По умолчанию индекс лежит в DuckDB и работает офлайн; для нескольких машин можно переключиться на Postgres с pgvector. Если ставить из PyPI, сборка может отставать от исходного дерева — тогда свежую версию берут из репозитория.
Какие задачи решает
- сохранить статью или PDF в базу знаний одной командой
- найти нужный рисунок по описанию среди всех заметок
- связать новую заметку с уже накопленными
- сжать старые заметки, чтобы поиск оставался дешёвым
- подгрузить цели и правила в начале сессии агента
Примеры запросов агенту
- Сохрани эту статью в базу:
save_articleпо ссылке - Найди панель с UMAP по меланоцитам через
search_figures - Покажи контекст сессии: цели, правила и топ заметок
Как установить second-brain MCP
Командой платформы
claude mcp add mcp-second-brain -- uvx mcp-second-brainuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>
Командой платформы
codex mcp add second-brain-mcp -- uvx mcp-second-brainuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>
Файл настроек
{
"mcpServers": {
"second-brain-mcp": {
"command": "uvx",
"args": [
"mcp-second-brain"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>
Файл настроек
{
"servers": {
"second-brain-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-second-brain"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>
Командой платформы
gemini mcp add second-brain-mcp uvx mcp-second-brainuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о second-brain MCP
Как установить second-brain MCP в Claude Code?
Сначала поставьте пакет и браузер: pip install mcp-second-brain и playwright install chromium. Затем добавьте сервер командой claude mcp add mcp-second-brain -- uvx mcp-second-brain.
Что делает second-brain MCP?
Ведёт личное хранилище заметок в Markdown: сохраняет статьи и PDF, распознаёт рисунки, строит эмбеддинги, автоматически связывает заметки и сжимает те, что давно не читали.
Что нужно для работы сервера?
Python 3.11–3.13 и Chromium для Playwright. Индекс по умолчанию хранится в DuckDB и работает офлайн, для нескольких машин доступен вариант с Postgres и pgvector.
