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 はグラフ + ベクトル + 全文検索を1つのコンテナ内で処理します。

• シンプルさのため、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）-- グラフ + ベクトル + 全文検索を1つのコンテナに内包

• 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