2D

28naem-del/mnemosyne

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

153 stars 14 forks Качество 81 Тренд 57MIT

Локальная долговременная память для агентов ИИ: сервер MCP, служба TypeScript SDK, CLI и HTTP через один файл SQLite. Воспоминания, подкрепленные доказательствами, исправления, которые удаляют устаревшее руководство, временную историю.

Обзор

Когда источник корректируется, каждое зависевшее от него воспоминание удаляется, поэтому следующий агент начинает с того, что все еще верно, вместо того, чтобы повторять устаревший урок. Мнемозин связывает память с ее последствиями: исправленное требование может отменить зависимую процедуру, неудачное испытание может удержать навык, а новый агент может возобновить явную передачу. Запустите локальный движок в одном файле SQLite; подключите хост через TypeScript, MCP, CLI или аутентифицированный HTTP с клиентом Python и живым инспектором. Отдайте память клиенту MCP. читает .mcp.json в корне проекта и читает .cursor/mcp.json; оба принимают одну и ту же запись сервера. Файл базы данных (режим 0600) и его родительский каталог (режим 0700) создаются при первом использовании. Относительные пути разрешаются из каталога, в котором клиент запускает сервер; используйте абсолютные пути, если ваш клиент запускает серверы в другом месте.

Обзор (машинный перевод)

Следующий агент начинает мудрее.

**Мнемозин - это долгосрочная память для агентов ИИ: один файл SQLite, который сохраняет то, что агент узнал вместе с доказательствами, которые он получил, служил любому хосту по TypeScript, MCP, CLI или HTTP. Когда источник корректируется, каждое зависевшее от него воспоминание удаляется, поэтому следующий агент начинает с того, что все еще верно, вместо того, чтобы повторять устаревший урок.

Мнемозин связывает память с ее последствиями: исправленное требование может отменить зависимую процедуру, неудачное испытание может удержать навык, а новый агент может возобновить явную передачу. Запустите локальный движок в одном файле SQLite; подключите хост через TypeScript, MCP, CLI или аутентифицированный HTTP с клиентом Python и живым инспектором.

2.0.0-rc.10 · Кандидат на релиз · MIT · Node.js ≥22.16

Веб-сайт · Quickstart · Документация · Примеры · Миграция · Измеренные результаты · npm · Вклад

##Установка и подключение агента

Отдайте память клиенту MCP. Claude Code читает .mcp.json в корне проекта и Cursor читает .cursor/mcp.json; оба берут один и тот же вход на сервер. Файл базы данных (режим 0600) и его родительский каталог (режим 0700) создаются при первом использовании.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Mnemosyne

The next agent starts wiser.

Mnemosyne is local-first, long-term memory for AI agents: one SQLite file that keeps what an agent learned together with the evidence it came from, served to any host over TypeScript, MCP, CLI or HTTP. When a source is corrected, every memory that depended on it is retired, so the next agent starts from what is still true instead of repeating a stale lesson.

Mnemosyne connects memory to its consequences: a corrected requirement can retire a dependent procedure, a failed trial can withhold a skill, and a new agent can resume from an explicit handoff. Run the local engine in one SQLite file; connect your host through TypeScript, MCP, CLI, or authenticated HTTP with a Python client and live inspector.

2.0.0 · Stable release · MIT · Node.js ≥22.16

Website · Quickstart · Documentation · Examples · Migration · Measured results · npm · Contributing

Install and connect an agent

npm install mnemosy-ai                   # latest = 2.0.0; pin [email protected] to reproduce
npx --no-install mnemosy demo            # offline: no API key, no server, no Docker

Give the memory to an MCP client. Claude Code reads .mcp.json in the project root and Cursor reads .cursor/mcp.json; both take the same server entry. The database file (mode 0600) and its parent directory (mode 0700) are created on first use. Relative paths resolve from the directory the client starts the server in; use absolute paths if your client launches servers elsewhere.

{
  "mcpServers": {
    "mnemosyne": {
      "command": "npx",
      "args": [
        "-y", "-p", "[email protected]", "mnemosy", "mcp",
        "--db", "./.mnemosyne/memory.sqlite",
        "--workspace", "my-project", "--agent", "assistant"
      ]
    }
  }
}

Claude Code can register the same server from the shell:

claude mcp add mnemosyne -- npx -y -p [email protected] mnemosy mcp --db ./.mnemosyne/memory.sqlite --workspace my-project --agent assistant
Открыть полный README на GitHub

Установка

npx -y -p [email protected] mnemosy mcp --db ./.mnemosyne/memory.sqlite --workspace my-project --agent assistant
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "mnemosyne": { "command": "npx", "args": [ "-y", "-p", "[email protected]", "mnemosy", "mcp", "--db", "./.mnemosyne/memory.sqlite", "--workspace", "my-project", "--agent", "assistant" ] } } }