neural-memory について
NeuralMemory は、AI エージェントに永続的な記憶を与える MCP サーバーです。記憶は相互に結びついたニューロンとして保存され、拡散活性化によって想起されます。ベクターデータベースや API 呼び出しを必要とせず完全オフラインで動作し、セッションをまたいで文脈を保持したい利用者に向いています。
主な機能
- 01拡散活性化による関連記憶の想起
- 02CAUSED_BY や LEADS_TO などの明示的な関係タイプ
- 03記憶の種類とタグの自動判定
- 04健康度スコアと改善提案
- 05ドキュメントからの知識取り込みとマルチデバイス同期
活用シーン
- 01コーディングエージェントがセッションをまたいでプロジェクトの決定や過去の修正を保持する
- 02障害の原因となった因果連鎖をたどる
- 03複数のマシン間で同じ記憶ストアを同期する
MCP 対応
MCP サーバーとして、nmem_remember、nmem_recall、nmem_health など 63 個のツールを提供し、MCP クライアントから記憶の保存と取得を行えるようにします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
NeuralMemory
AI エージェントはセッション間ですべてを忘れてしまいます。Neural Memory が脳を与えます。
ウェブサイト · クイックスタート · MCP ツール · Pro · 変更履歴
記憶は相互につながったニューロンとして保存され、活性化の伝播によって呼び起こされます。これは人間の脳と同じ仕組みです。ベクトルデータベースは不要です。API 呼び出しもありません。毎月の埋め込み料金もかかりません。
pip install neural-memory
AI ツールを再起動してください。エージェントが記憶できるようになります。init は不要で、MCP サーバーは初回使用時に自動で初期化されます。
すでにインストール済みですか? nmem update は、pip 経由かソースからインストールしたかを検出し、そのままアップグレードします。nmem update --check は、利用可能な更新を報告するだけです。
CLI は
nmem(または長い形式のneural-memory)です。nmバイナリはありません。
ツールは3つ。それだけです。
MCP ツールは63個ありますが、必要なのは3つだけです。
| ツール | 機能 |
|---|---|
nmem_remember | 記憶を保存します。種類、タグ、関連性を自動検出します |
nmem_recall | 活性化の伝播を通じて記憶を呼び起こします。関連する記憶が自然に浮かび上がります |
nmem_health | 実行可能な修正案を提示する、脳の健康スコア(A〜F) |
その他の機能(セッション、コンテキストの読み込み、習慣の追跡、メンテナンス)はすべて、バックグラウンドで透過的に動作します。
他との違い
多くの記憶ツールは検索エンジンです。Neural Memory は思考するグラフです。
「火曜日の障害はなぜ起きたのか?」と尋ねたとき、ベクトルデータベースは最も類似した文章を返します。Neural Memory は次のように連鎖をたどります。
outage ← CAUSED_BY ← JWT expiry ← SUGGESTED_BY ← Alice's review
関係性は明示的です — CAUSED_BY、LEADS_TO、RESOLVED_BY、CONTRADICTS — そのため、エージェントは記憶を見つけるだけでなく、記憶をたどって推論できます。
| 検索ベース(RAG) | Neural Memory | |
|---|---|---|
| 検索 | 類似度スコア | グラフの探索 |
| 関係性 | なし | 24種類の明示的なタイプ |
| LLM が必要 | はい(埋め込み) | いいえ — 完全オフライン |
| マルチホップ推論 | 複数のクエリ | 1回の探索 |
| 記憶のライフサイクル | 静的 | 減衰、強化、統合 |
| クエリ1,000回あたりのコスト | 約$0.02 | $0.00 |
クラウド同期 — あなたのデータ、あなたのインフラ
あらゆるマシンで脳を同期できます。他のメモリツールとは異なり、私たちはあなたのデータを一切保存しません。
Laptop ←→ Your Cloudflare Worker ←→ Desktop
↕
Your Phone
同期ハブはあなた自身のCloudflareアカウント(無料枠)にデプロイします。あなたのD1データベース、あなたの暗号化キー、あなたのデータです。コードは私たちが提供します。インフラの所有者はあなたです。
nmem sync # push/pull changes
nmem sync --auto # auto-sync after every remember/recall
同期にはMerkle差分を使用します。脳全体ではなく、差分のみが転送されます。高速で効率的、そしてプライベートです。
機能
メモリと想起
- 14種類のメモリ — 事実、決定、エラー、洞察、好み、ワークフロー、指示など
- 拡散活性化 — キーワードの一致ではなく、関連性によってメモリが表面化します
- 認知的推論 — 仮説を立て、証拠を提出し、予測し、ベイズ信頼度で検証します
- ワークロードプリセット —
nmem config preset {balanced,safe-cost,max-recall,chat-heavy}で、SaaS、節約モード、深い保持、会話型エージェント向けに脳を調整できます - 時間的想起 —
nmem_causalはtemporal_rangeとtemporal_neighborhoodアクションを提供します。時間的想起のレシピガイドをご覧ください
ナレッジの取り込み
- ドキュメントから学習 — PDF、DOCX、PPTX、HTML、JSON、XLSX、CSVを取り込み、脳の永続的なナレッジにします
- インポートアダプター — 1つのコマンドでChromaDB、Mem0、Cognee、Graphiti、LlamaIndexから移行できます
ライフサイクルとストレージ
- メモリの統合 — エピソード記憶は時間とともに成熟し、意味的なナレッジになります
- 圧縮ティア — full → summary → essence → ghost → metadata(意味を保ちながらストレージを再利用)
- 脳のバージョン管理 — 脳間でメモリのスナップショット、ロールバック、差分表示、移植ができます
コミュニティ
- Brain Store — コミュニティマーケットプレイスで、構築済みの脳を閲覧、インポート、公開できます
- 3つのシード脳 — Pythonのベストプラクティス、Gitワークフロー、Dockerの基礎(すぐにインポート可能)
エコシステム
- ウェブダッシュボード — グラフ表示、ヘルスレーダー、タイムライン、マインドマップ、Brain Storeを備えた7ページ構成のReact UI
- VS Code拡張機能 — メモリツリー、グラフエクスプローラー、CodeLens、WebSocket同期(Marketplace →)
- 安全性 — Fernet暗号化、機密コンテンツの自動検出、パラメーター化SQL、パス検証
- Telegramバックアップ — オフサイトバックアップ用に脳の
.dbファイルをTelegramに送信できます
使用例
# Store memories (type auto-detected)
nmem remember "Fixed auth bug with null check in login.py:42"
nmem remember "We decided to use PostgreSQL" --type decision
nmem todo "Review PR #123" --priority 7
# Recall
nmem recall "auth bug"
nmem recall "database decision" --depth 2
# Brain management
nmem brain list && nmem brain health
nmem brain export -o backup.json
# Sync across devices
nmem sync --full
# Web dashboard
nmem serve # http://localhost:8000/dashboard
import asyncio
from neural_memory import Brain
from neural_memory.storage import InMemoryStorage
from neural_memory.engine.encoder import MemoryEncoder
from neural_memory.engine.retrieval import ReflexPipeline
async def main():
storage = InMemoryStorage()
brain = Brain.create("my_brain")
await storage.save_brain(brain)
storage.set_brain(brain.id)
encoder = MemoryEncoder(storage, brain.config)
await encoder.encode("Met Alice to discuss API design")
await encoder.encode("Decided to use FastAPI for backend")
pipeline = ReflexPipeline(storage, brain.config)
result = await pipeline.query("What did we decide about backend?")
print(result.context) # "Decided to use FastAPI for backend"
asyncio.run(main())
Neural Memory Pro
無料版のNeural Memoryは完全な機能を備えています。63個のツール、無制限のメモリ、完全なオフライン動作を利用できます。料金を支払う必要はありません。
しかし、メモリが10Kを超えると状況が変わります。キーワードマッチングでは意味的に関連するコンテンツを見逃します。統合に数分かかるようになります。ストレージは際限なく増えます。エージェントの脳が大きくなってきたら、Proがそれを賢くします。
無料版はキーワードで想起します。Proは意味で想起します。
Query: "authentication improvements"
Free (FTS5): 2 results — exact matches only
Pro (HNSW): 7 results — includes "JWT rotation", "session hardening", "OAuth migration"
Proで追加される機能
| 無料版(SQLite) | Pro(InfinityDB) | |
|---|---|---|
| 想起 | キーワードマッチング(FTS5) | 意味的類似性(HNSW) |
| 100万ニューロン時の速度 | ~500ms | <5ms |
| テスト済みの規模 | ~50Kニューロン | 200万以上のニューロン |
| 圧縮 | テキストレベルのトリミング | 5段階ベクトル圧縮(97%削減) |
| 統合 | O(N²)の総当たり処理 | O(N×k)のHNSWクラスタリング |
| 100万件あたりのストレージ | ~5 GB | ~1 GB |
| クラウド同期 | 手動プッシュ/プル | Merkle差分(自動、差分のみ) |
Pro限定機能
- コーンクエリ — 調整可能な意味的想起。精度を高めるにはコーンを狭め、探索するには広げます
- スマートマージ — HNSW近傍クラスタリングにより、100万以上のニューロンに対応する統合
- 方向性圧縮 — 意味を保ちながら、複数の意味的軸に沿って圧縮します
- 5段階の自動ライフサイクル — メモリはfloat32 → float16 → int8 → binary → metadataと移行します。アクセス時に自動的に昇格します
Pro を入手する
pip install neural-memory # Pro features included
nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX # activate license
nmem shared status # verify: Pro: Active
月額 $9 — 30 日間の返金保証付きです。無料ツールはすべて引き続きご利用いただけます。いつでもダウングレードでき、データもそのまま保持されます。
ツール別のセットアップ
Claude Code(プラグイン)
/plugin marketplace add nhadaututtheky/neural-memory
/plugin install neural-memory@neural-memory-marketplace
Cursor / Windsurf / その他の MCP クライアント
pip install neural-memory
エディターの MCP 設定に追加します:
{
"mcpServers": {
"neural-memory": { "command": "nmem-mcp" }
}
}
OpenClaw(スキルまたはプラグイン)
スキル — ClawHub からワンクリックでインストールできます。 リリースごとに公開されます:
clawhub.ai/skills/neural-memory
プラグイン — メモリスロットの置き換え。 NeuralMemory を、OpenClaw が呼び出すスキルではなく、OpenClaw のメモリプロバイダーとして使いたい場合に選択してください:
pip install neural-memory && npm install -g neuralmemory
~/.openclaw/openclaw.json でメモリスロットを設定します:
{ "plugins": { "slots": { "memory": "neuralmemory" } } }
Pro にアップグレード
すでに Neural Memory をお使いですか? キーを有効化するだけです:
nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX # activate license
次に、InfinityDB(セマンティック検索エンジン)を有効にします:
# ~/.neuralmemory/config.toml
storage_backend = "infinitydb"
MCP サーバーを再起動してください。既存のメモリは初回起動時に SQLite から InfinityDB に自動移行されます。
インストールの補足
pip install neural-memory[server] # FastAPI server + dashboard
pip install neural-memory[extract] # PDF/DOCX/PPTX/HTML/XLSX extraction
pip install neural-memory[nlp-vi] # Vietnamese NLP
pip install neural-memory[embeddings] # Local embedding models
pip install neural-memory[embeddings-openai] # OpenAI embeddings
pip install neural-memory[all] # Everything
他のツールとのベンチマーク比較
| 指標 | NeuralMemory | Mem0 | Cognee |
|---|---|---|---|
| メモリ 50 件の書き込み | 1.2s | 148.2s(121 倍遅い) | 290.6s(80 倍遅い) |
| クエリ 20 件の読み取り | 1.8s | 2.9s | 34.6s |
| API 呼び出し | 0 | 70 | 149 |
LLM 呼び出しはゼロ、API コストもゼロです。ベンチマークの詳細 → · 認知効率リリースのエビデンス →
ドキュメント
| ガイド | 説明 |
|---|---|
| クイックスタートガイド | アニメーションデモ付きのインタラクティブガイド |
| Pro クイックスタート | Pro 機能を使い始める |
| CLI リファレンス | CLI コマンド全 82 件 |
| MCP ツールリファレンス | パラメーター付きの MCP ツール全 63 件 |
| クラウド同期 | 複数デバイス間の同期設定 |
| ブレインヘルスガイド | ブレインヘルスの理解と改善 |
| 埋め込みのセットアップ | 埋め込みプロバイダーの設定 |
| アーキテクチャ | 技術設計の詳細 |
開発
git clone https://github.com/nhadaututtheky/neural-memory
cd neural-memory && pip install -e ".[dev]"
nmem doctor --dev # Verify contributor setup
pytest tests/ -v # 7800+ tests
ruff check src/ tests/ # Lint
ガイドラインについては、CONTRIBUTING.md をご覧ください。
サポート
Neural Memory が AI エージェントの記憶に役立っている場合は、ぜひスターを付けてください。他の人がこのプロジェクトを見つけやすくなり、開発の継続にもつながります。
プロジェクトをスポンサーとして支援することもできます。
ライセンス
MIT — LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。