Mnemosyne

Общий MCP-сервер памяти GraphRAG для 3 агентов Hermes. Полностью локальный — никакие данные не покидают сеть.

Архитектура

Machine 1 (HOST: this PC)         Machine 2         Machine 3
+--------------------------+    +-------------+    +-------------+
| Neo4j (Docker)           |    | Hermes      |    | Hermes      |
| Ollama (native)          |<---| Agent       |    | Agent       |
| MCP server (Python)      | MCP| (client)    |    | (client)    |
|   Port 8080              |    +-------------+    +-------------+
+--------------------------+

• Машина 1 запускает всё. Машины 2 и 3 — чистые MCP-клиенты.

• Neo4j обрабатывает граф, вектор и полнотекстовый поиск в одном контейнере.

• Ollama работает нативно (не в Docker) для простоты.

• MCP — нативный протокол Hermes; агенты получают инструменты памяти как возможности первого класса.

Related MCP server: Knowledge Graph Memory Server

Быстрый старт

# 1. Clone and configure
git clone https://github.com/DarylAndrian/Mnemosyne.git
cd Mnemosyne
cp .env.example .env
# Edit .env with your passwords

# 2. Start Neo4j
docker compose up -d

# 3. Install Python deps
uv venv .venv
uv pip install -r requirements.txt

# 4. Start the server
python -m server.main

Сервер запускается на http://0.0.0.0:8080/mcp. Проверка здоровья — на /health.

Переменные окружения

MCP-инструменты

remember(content, agent_id, session_id?, tags?)

Сохраняет память. Сервер извлекает сущности, связи и факты в граф знаний. Обнаруживает конфликты с существующими фактами.

recall(query, top_k?, agent_id?)

Гибридный RAG-поиск: векторное сходство + ключевые слова + расширение по окрестности графа. Объединяется с учётом недавности и количества обращений.

context(entity_name, depth_limit?)

Обход окрестности графа. Возвращает все рёбра, связанные с сущностью, в пределах 1–3 переходов.

resolve(entity_a, entity_b)

Объединяет дублирующиеся сущности. Перенаправляет все рёбра, сохраняет оба имени как псевдонимы.

forget(memory_id)

Мягкое удаление эпизода. Сохраняет происхождение.

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

Добавьте в конфигурацию Hermes:

{
  "mcpServers": {
    "mnemosyne": {
      "url": "http://<HOST_IP>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <MCP_API_KEY>"
      }
    }
  }
}

Инфраструктура

• Neo4j 5.26 (Community) — граф + вектор + полнотекстовый поиск в одном контейнере

• Ollama 0.32+ — qwen2.5:3b (извлечение) + nomic-embed-text (эмбеддинги)

• Python 3.11+ — FastMCP-сервер с транспортом Streamable HTTP

• Docker Compose — только Neo4j (Ollama остаётся нативной)

Разработка

# Run integration tests (requires live stack)
.venv/Scripts/python.exe -c "from tests.test_integration import *; ..."

Лицензия

MIT