# second-brain MCP

Локальная база знаний в Markdown, которую ИИ-агент читает, пополняет и сам поддерживает в порядке. Пригодится, если заметки и статьи копятся быстрее, чем вы успеваете их разбирать.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: ddmanyes
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ddmanyes/second-brain-mcp
- Обновлён: 2026-09-12
- HTML: https://affpapa.org/nevibecode/mcp/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, сборка может отставать от исходного дерева — тогда свежую версию берут из репозитория.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-second-brain -- uvx mcp-second-brain
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>

### Codex

**Командой платформы**
```bash
codex mcp add second-brain-mcp -- uvx mcp-second-brain
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "second-brain-mcp": {
            "command": "uvx",
            "args": [
                "mcp-second-brain"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "second-brain-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-second-brain"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add second-brain-mcp uvx mcp-second-brain
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-second-brain <команда>

## Когда брать
- сохранить статью или PDF в базу знаний одной командой
- найти нужный рисунок по описанию среди всех заметок
- связать новую заметку с уже накопленными
- сжать старые заметки, чтобы поиск оставался дешёвым
- подгрузить цели и правила в начале сессии агента

## Примеры запросов агенту
- Сохрани эту статью в базу: `save_article` по ссылке
- Найди панель с UMAP по меланоцитам через `search_figures`
- Покажи контекст сессии: цели, правила и топ заметок

## Похожие
- [second-brain-query](https://affpapa.org/nevibecode/skills/second-brain-query.md) — скилл · 2500 установок
- [second-brain-ingest](https://affpapa.org/nevibecode/skills/second-brain-ingest.md) — скилл · 2500 установок
- [second-brain](https://affpapa.org/nevibecode/skills/coreyhaines31-second-brain.md) — скилл · 355 установок
- [company-brain](https://affpapa.org/nevibecode/skills/company-brain.md) — скилл · 357 установок
- [Open Brain](https://affpapa.org/nevibecode/mcp/open-brain.md) — MCP-сервер · ★ 8
- [myco-brain](https://affpapa.org/nevibecode/mcp/myco-brain.md) — MCP-сервер · ★ 7

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md