# memharness

Долговременная память для ИИ-агентов в локальной базе SQLite. Фиксирует факты, время их появления в реальном мире, дату записи и источник информации.

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

## Что делает

Сервер сохраняет знания агента в локальный файл `~/.memharness/memory.db`. Для записи не нужны вызовы нейросетей, внешние API или фоновые демоны. Вся работа идёт через обычный SQLite. При изменении данных старый факт не стирается, а связывается с новым через замену, сохраняя историю рассуждений.

Система отслеживает два временных параметра: момент, когда событие произошло в мире, и время, когда агент о нём узнал. Это позволяет запрашивать картину мира на конкретную прошлую дату или строить разницу между состояниями с помощью команды `diff`. Каждый факт хранит источник. По нему можно очистить память по отдельной сессии или файлу.

Сервер не умеет автоматически вычленять факты из свободного диалога. Модель или скрипт запуска должны сами вызывать инструменты `remember`, `recall` или `revise`. Путь к базе настраивается через переменную `MEMHARNESS_DB`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MEMHARNESS_DB` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env MEMHARNESS_DB=<MEMHARNESS_DB> --transport stdio memharness -- npx -y @memharness/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add memharness --env MEMHARNESS_DB=<MEMHARNESS_DB> -- npx -y @memharness/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "memharness": {
            "command": "npx",
            "args": [
                "-y",
                "@memharness/mcp"
            ],
            "env": {
                "MEMHARNESS_DB": "<MEMHARNESS_DB>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "memharness": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@memharness/mcp"
            ],
            "env": {
                "MEMHARNESS_DB": "<MEMHARNESS_DB>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MEMHARNESS_DB=<MEMHARNESS_DB> memharness npx -y @memharness/mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Запомни, что прод развёрнут на сервере Fly.io
- Что ты знаешь о текущих параметрах деплоя и откуда эта информация?
- Покажи, какие факты изменились с прошлого понедельника

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47577
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43902

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