Aether-liusiqi/cell-mem

cell-mem は何をしますか？

AIエージェント向けの脳にインスパイアされた記憶システム。ワーキングメモリ、エピソディックメモリ、セマンティックメモリ、プロシージャルメモリの4つの記憶層を持ち、統合、自己反省、生成的再生、創造的な仮説発見を実現します。Claude Code & Codex CLI向けのMCPサーバーとして提供されます。

概要

• 4つの記憶層: ワーキング、エピソディック、セマンティック、プロシージャル
• 動的ツール定義: memory_tools リソース経由で利用可能なツールをエージェントに通知
• 統合プロセス: 定期的な統合により、断片的な記憶を構造化された知識に変換
• 自己反省: エピソディックメモリのパターンを分析し、洞察を生成
• 生成的再生: 過去の経験から新しい関連パターンを生成
• 仮説発見: セマンティックメモリ内の未知のパターンを探索
• 外部ツール統合: read_file や write_file などのツールをエージェントに公開
• LLMに依存しない設計: 内部でLLM呼び出しを行わず、エージェントの思考に依存

アーキテクチャ

cell-memは、人間の記憶システムに着想を得た4つの記憶層で構成されています:

1. ワーキングメモリ: 短期間のタスク指向の記憶を保持
2. エピソディックメモリ: 過去の経験や出来事を保存・検索
3. セマンティックメモリ: 抽象化された知識と概念を管理
4. プロシージャルメモリ: 手続き的なスキルとパターンを保存

コアプロセス

• 統合: ワーキングメモリからエピソディックメモリへ、さらにセマンティックメモリへと断片的な記憶を統合し、パターンを抽出します。
• 自己反省: エピソディックメモリの集約されたビューに対して分析を行い、洞察を生成します。
• 生成的再生: エピソディックメモリのパターンから新しいパターンを生成し、セマンティックメモリに保存します。
• 創造的仮説発見: セマンティックメモリの埋め込み空間を探索し、未知のパターンや関係性を発見します。

セットアップ

前提条件

• Python 3.10以上
• uv パッケージマネージャー（推奨）または pip

インストール

# パッケージをインストール
uv add aether-cell-mem

Claude Codeでの設定

~/.claude/settings.json に以下の設定を追加:

{
  "mcpServers": {
    "cell-mem": {
      "command": "uvx",
      "args": ["aether-cell-mem"]
    }
  }
}

他のMCPクライアント（Claude Desktopなど）でも同様の設定が可能です。

Codex CLIでの設定

Codex CLIは、.codexclirc.yaml で標準的なMCPサーバー設定をサポートしています:

mcpServers:
  cell-mem:
    command: uvx
    args:
      - aether-cell-mem

使用方法

エージェントのワークフロー

MCPサーバーに接続されたエージェントは、以下のように対話します:

1. list_resource_templates を呼び出して利用可能なリソースを確認
2. memory_tools リソースを読み取り、利用可能なツールを動的に取得
3. タスクに応じて適切なツールを選択・呼び出し

実装例

from cell_mem import CellMem

# セッションの初期化
mem = CellMem()
await mem.initialize()

# セッション内で使用可能
await mem.run_tool("store_working", {
    "content": "現在のタスクのコンテキスト",
    "tags": ["python", "debugging"]
})

開発ガイド

プロジェクト構造

cell_mem/
├── __init__.py
├── __main__.py        # MCPサーバーのエントリーポイント
├── server.py          # MCPサーバーの実装
├── memory_manager.py  # 記憶層の管理
├── layers/
│   ├── working.py
│   ├── episodic.py
│   ├── semantic.py
│   └── procedural.py
├── operations/
│   ├── consolidate.py
│   ├── reflect.py
│   ├── replay.py
│   └── discover.py
└── storage/
    └── store.py

ディレクトリ構造のテスト

このコマンドを実行して、ソースツリー内のセマンティックなパターンを抽出できます（フラット化された列挙）:

# 実装のパターンを発見
find ./cell_mem -type f -name "*.py" | sort

ロードマップ

• コアMCPサーバーの実装
• 4つの記憶層
• 動的ツール定義
• 統合プロセス
• 自己反省機能
• 生成的再生機能
• 仮説発見機能
• 外部ツール統合
• claude_code_cell_mem パッケージの改善版（進行中）
• クロスプラットフォームサポートの拡張
• Codex CLIとの統合改善
• パフォーマンス最適化

貢献

貢献を歓迎します！詳細は CONTRIBUTING.md をご覧ください。