Mnemosyne

3개의 Hermes 에이전트를 위한 공유 GraphRAG 메모리 MCP 서버. 완전히 로컬에서 동작합니다 — 데이터가 네트워크 밖으로 나가지 않습니다.

아키텍처

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가 그래프 + 벡터 + 전문(full-text) 검색을 하나의 컨테이너에서 처리합니다.

• 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)

에피소드를 소프트 삭제합니다. 출처(provenance)를 보존합니다.

에이전트 구성

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+ — Streamable HTTP 전송을 사용하는 FastMCP 서버

• Docker Compose — Neo4j만 (Ollama는 네이티브 유지)

개발

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

라이선스

MIT