# Mnemolith

Mnemolith — MCP-сервер для Claude Code, сохраняющий единую память ИИ-агентов с привязкой к хэшам файлов в git. Срабатывает при сохранении и поиске контекста проекта между сессиями.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: anishchugh05
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/anishchugh05/mnemolith
- Обновлён: 2026-11-17
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — внимание: команда скачивает скрипт с mnemolith.dev и сразу его запускает; команда PowerShell скачивает скрипт с mnemolith.dev и сразу его выполняет. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/mcp/mnemolith

## Что делает

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

Архитектура совмещает Python для вычисления эмбеддингов и синхронизации с git-хэшами и Java-движок, поддерживающий протокол RESP, HNSW-индекс для векторного поиска и append-only файл на диске. Актуальные факты могут синхронизироваться в секции `AGENTS.md` и `CLAUDE.md`, а командные записи хранятся в репозитории через файл `mnemolith.md`.

Для запуска нужен пакетный менеджер `uvx` (или установленный пакет `mnemolith` из PyPI). В интерфейсе `mnemolith ui` доступен просмотр конфликтов и сравнение версий файлов.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Запомни, что тесты запускаются через docker compose, и свяжи это с docker-compose.yml
- Вспомни конфигурацию базы данных для локальной разработки
- Покажи историю и источник записи о правилах деплоя

## Похожие
- [V3 Memory Unification](https://affpapa.org/nevibecode/skills/v3-memory-unification.md) — скилл · 1100 установок
- [v3-memory-specialist](https://affpapa.org/nevibecode/agents/v3-memory-specialist.md) — субагент · ★ 850 у репозитория
- [memory-specialist](https://affpapa.org/nevibecode/agents/memory-specialist.md) — субагент · ★ 189 у репозитория
- [conversation-memory](https://affpapa.org/nevibecode/skills/sickn33-conversation-memory.md) — скилл · 1600 установок
- [add-agent-memory](https://affpapa.org/nevibecode/skills/add-agent-memory.md) — скилл · 113 установок
- [Nacre](https://affpapa.org/nevibecode/mcp/nacre.md) — MCP-сервер · ★ 2 у репозитория

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