# CogniRepo

Локальный MCP-сервер для долговременной памяти и графа связей кода. Помогает агентам помнить контекст решений и быстрее находить символы в проекте.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Автор: ashlesh-t
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ashlesh-t/cognirepo
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/cognirepo

## Что делает

Сервер добавляет постоянную память для рабочих сессий ассистента в кодовой базе. Внутри работают векторное хранилище FAISS для заметок и обратный индекс AST. За счёт этого агент быстро находит объявления функций и классов без медленного перебора через `grep`. Все 36 инструментов выполняются локально и не требуют ключей к внешним API.

Инструмент ведёт журнал событий и сохраняет историю прошлых диалогов. Он фиксирует ошибки с подсказками для агента, чтобы модель не повторяла один и тот же сбой. Накопленный контекст не сбрасывается при закрытии терминала или смене инструмента.

Для запуска нужен Python 3.11+ и утилита `uvx`. В небольших репозиториях схема 36 инструментов забирает около 3700 токенов, поэтому точечные вызовы окупают накладные расходы только после 4 обращений к серверу.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Найди место объявления класса `DatabaseSession` и покажи граф его вызовов
- Запиши архитектурное решение по переходу на асинхронные очереди
- Проверь по журналу ошибок, почему прошлый запуск тестов завершился сбоем

## Похожие
- [telemem](https://affpapa.org/nevibecode/mcp/telemem.md) — MCP-сервер · ★ 494
- [coldstart](https://affpapa.org/nevibecode/mcp/coldstart.md) — MCP-сервер · ★ 11
- [tooluniverse](https://affpapa.org/nevibecode/mcp/tooluniverse.md) — MCP-сервер · ★ 1760
- [Local FAISS MCP Server](https://affpapa.org/nevibecode/mcp/local-faiss-mcp-server.md) — MCP-сервер · ★ 36
- [velocirag](https://affpapa.org/nevibecode/mcp/velocirag.md) — MCP-сервер · ★ 12
- [ast-grep-outline](https://affpapa.org/nevibecode/skills/ast-grep-outline.md) — скилл · 2400 установок

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