mnemos
あなたのコーディングエージェントのための自動操縦型ナレッジベース。
一度インストールすれば、あとはエージェントがコーディング中にプロジェクトの構造化されたナレッジベースを自動的に構築します。プロンプトを覚える必要も、remember()を呼び出す必要も、新しいAPIを学ぶ必要もありません。
単一のGoバイナリ。埋め込みSQLite。クラウド不要。Docker不要。Python不要。Nodeランタイム不要。
Agent (Claude Code / Cursor / Kiro / Gemini CLI / ...)
↓ MCP stdio
mnemos serve
↓
Auto-compiled knowledge base (~/.mnemos/mnemos.db)mnemosが他と違う理由
すべてのメモリサーバーはテキストを保存しますが、Mnemosはナレッジベースをコンパイルします。
他のサーバーでは、いつ保存し、いつ取得するかをユーザー（または慎重に調整されたプロンプト）が決定する必要がありますが、mnemosはバックグラウンドで完全なパイプラインを実行します：
Agent action → mnemos auto-pipeline:
├── Quality gate (reject/rewrite low-value content)
├── 3-tier dedup (hash → fuzzy → semantic)
├── Auto-summarize (extractive, fast; LLM if available)
├── File linking (extract identifiers, link to code)
├── Type classification (episodic / long_term / semantic / working)
├── Quality scoring (for retrieval ranking)
└── Decay scheduling (so knowledge base stays relevant)
Retrieval:
├── Hybrid search (FTS5 + optional semantic + RRF)
├── File-overlap boost (memories about active files rank higher)
├── MMR diversity (kill redundant results)
├── Adaptive packing (full content or summary based on budget)
└── Token-budget cap (always fits in context)これらを呼び出す必要はありません。エージェントが呼び出す必要もありません。セッション開始時、プロンプト送信時、セッション終了時にフックが自動的に実行されます。
Related MCP server: RecallNest
今日から使える3つのレイヤー
レイヤー1 — MCPトランスポート。 標準的なMCPサーバーであり、stdio経由で任意のMCPクライアントと連携します。
レイヤー2 — 自動操縦フック。 1つのコマンド（mnemos setup claude）で、フック、ステアリング、MCP設定を統合します。セッション開始時に適切なコンテキストを自動注入し、プロンプト送信時にトピックの変化に応じて自動検索を行い、セッション終了時にカバレッジを検証します。
レイヤー3 — 自動コンパイル型ナレッジベース。 品質ゲート、3段階の重複排除、自動要約、ファイルリンク、MMRコンテキスト構築など、すべてが自動化されています。手動でトリガーする必要はありません。メモリベース全体にわたる陳腐化、矛盾、欠落した関係を継続的に検出するパッシブバックグラウンドデーモンが含まれています。
正直な比較
Mem0 | Zep/Graphiti | engram | OMEGA | mnemos | |
MCPネイティブ | ✓ | ✓ | ✓ | ✓ | ✓ |
単一バイナリ、ランタイム依存なし | — | — | ✓ | — | ✓ |
クラウド不要 / ローカルファースト | 部分的 | — | ✓ | ✓ | ✓ |
1コマンドで自動操縦セットアップ | — | — | — | — | ✓ |
自動品質ゲート | — | — | — | — | ✓ |
自動要約 | — | — | — | — | ✓ |
自動ファイルリンク (git対応) | — | — | — | — | ✓ |
MMRコンテキスト構築 | — | — | — | — | ✓ |
パッシブバックグラウンドデーモン | — | — | — | — | ✓ |
時間的ナレッジグラフ | — | ✓ | — | — | 部分的 (減衰 + 上書き) |
セルフホストコスト | $0-クラウド | ~$50/月 (Neo4j) | $0 | $0 | $0 |
MnemosはZepを目指しているわけではありません。アプローチが異なります。ビジネス事実に関する時間的推論が必要で、エンタープライズインフラがある場合はZepが最適です。Mnemosは、ラップトップ上で自動的に動作するナレッジベースを求めるコーディングエージェントユーザーにとって最適な選択肢です。
インストール
# Homebrew (macOS / Linux)
brew install s60yucca/tap/mnemos && mnemos setup claude
# curl (verify mnemos.dev is live before using)
curl -fsSL https://mnemos.dev/install.sh | bash && mnemos setup claude
# npm (coming in v1.2)
# npx mnemos setup claude
# Build from source (requires Go 1.23+)
git clone https://github.com/s60yucca/mnemos
cd mnemos && make buildclaudeの部分をcursor、kiro、またはgemini-cliに置き換えてください。クライアントを再起動すれば、そこから自動操縦が始まります。
自動操縦の実際の動作
mnemos setup <client>は以下を書き込みます：
ステアリングファイル (
CLAUDE.md,.cursorrules,.kiro/steering/mnemos.md) — 何を保存すべきかをエージェントに指示しますフック設定 (
.claude/hooks.jsonなど) — ライフサイクルイベントを接続しますMCP設定 (
.mcp.json) —mnemos serveをツールプロバイダーとして登録します
3つのフックが自動的に実行されます：
セッション開始 → mnemos hook session-start
トークン予算内で関連するメモリを収集（MMRによる多様化、ファイルブースト）。コンテキストに注入します。コールドスタートは200ms未満です。
プロンプト送信 → mnemos hook prompt-submit
トピックと意図の変化を検出します。変化が重要な場合にナレッジベースを自動検索します。ノイズを避けるためにクールダウンを尊重します。
セッション終了 → mnemos hook session-end
永続的なメモリがキャプチャされたかを確認します。必要に応じて最小限のパンくずリストを保存し、セッション状態をクリーンアップします。
ステアリングはエージェントに「何を記憶すべきか」を伝えます。フックは取得、重複排除、要約、リンクを処理するため、エージェントはメモリ管理のためにトークンを浪費しません。
パッシブ自動操縦デーモン
フックに加えて、mnemosはナレッジベースを継続的に改善するバックグラウンドデーモンを実行します：
陳腐化検出 — 削除されたファイルや古いパターンを参照しているメモリにフラグを立てます
矛盾検出 — 互いに矛盾するメモリを見つけます
関係推論 — 関連するメモリを自動的にリンクします
バックフィル — 要約が欠けているメモリに対して遡及的に要約を生成します
mnemos autopilot status # check daemon state
mnemos autopilot run # trigger immediate run
mnemos autopilot run --dry-run # preview findings without writing
mnemos autopilot report # view latest findingsパフォーマンスベンチマーク (レイテンシ)
操作 | 350メモリ | 1,500メモリ |
| 57 ms | 24 ms |
| 55 ms | 22 ms |
| 42 ms | 39 ms |
| 27 ms | 108 ms |
hook session-start (コールド) | < 200 ms | — |
バイナリサイズ | ~12 MB | — |
ハードウェア: M1 Pro, 16GB RAM, SSD上のSQLite。レイテンシは環境により異なります。
ほとんどの操作はデータセットのサイズに関係なく60ms以下です。フックサブコマンドはInitLightモードを使用するため、バックグラウンドワーカーやセッションの中断はありません。
価値ベンチマーク（トークン節約、精度、落とし穴の回避）は進行中です。 手法についてはDOGFOODING_RUNBOOK.mdを参照してください。公開前に実際の数値に置き換わります。
MCPツール
ツール | 内容 |
| メモリを保存（フル自動パイプラインが透過的に実行） |
| ハイブリッドFTS + セマンティック + ファイル重複検索（MMR付き） |
| セッション開始用に予算を考慮した多様なコンテキストを構築 |
| IDで取得 |
| コンテンツ、要約、タグを更新 |
| ソフト削除（maintain経由で復元可能） |
| 2つのメモリをリンク（supersedes, caused_by, depends_on） |
| 減衰、アーカイブ、GC、陳腐化検出を実行 |
インストール後のクイックスタート
# Agents call these automatically via MCP. You can also use directly:
mnemos store "JWT uses RS256, 1h expiry, config in auth/config.go"
mnemos search "token expiry"
mnemos stats
mnemos maintain設定
ほとんどのユーザーは触れる必要はありませんが、必要な場合は以下を参照してください：
# ~/.mnemos/config.yaml
embeddings:
provider: noop # noop (default) | ollama | openai
# Pure FTS works fine. Enable semantic for meaning-based search.
quality_gate:
min_words: 5
max_words: 200
min_density: 0.3
require_specific: true # long_term memories need project identifiers
duplicate_threshold: 0.8
summarization:
extractive: true # always on, fast, offline
file_linking:
enabled: true # auto-disables outside git
hook:
enabled: true
search_cooldown: 5m
session_start_max_tokens: 2000
mmr_lambda: 0.7 # 0=max diversity, 1=max relevance
file_boost: 0.3
autopilot:
enabled: true
interval: 15m
contradiction_enabled: falseメモリタイプ
Mnemosは自動分類します。--typeフラグで手動上書きも可能です。
タイプ | 減衰率 | 用途 |
| 速い (~1日) | TODO、一時メモ、WIP |
| 中程度 (~1ヶ月) | セッションイベント、バグ修正 |
| 遅い (~6ヶ月) | アーキテクチャの決定 |
| 非常に遅い | 事実、定義、知識 |
| 速い | アクティブなタスクコンテキスト |
なぜこれを作ったのか
毎朝Claude Codeに自分のプロジェクトを説明し直すことに疲れたからです。
既存のメモリサーバーを試しましたが、ほとんどはテキストを保存するだけでした。しかし、どれも「いつ保存し、いつ取得するか」を私自身や慎重に調整されたプロンプトに委ねていました。それはナレッジベースではなく、MCPラッパー付きのデータベースに過ぎません。
Mnemosは、それを真に自動化するために私が作ったものです。mnemos setup claudeを実行してエディタを再起動すれば、ナレッジベースが勝手にコンパイルされます。
自動操縦セットアップ — クライアントごとに1コマンド
mnemos setup claude # writes CLAUDE.md, .claude/hooks.json, .mcp.json
mnemos setup cursor # writes .cursorrules, .mcp.json
mnemos setup kiro # writes .kiro/steering/mnemos.md, .kiro/mcp.json
mnemos setup gemini-cli # writes GEMINI.md, .gemini/settings.json, .mcp.jsonフラグ: --global (全プロジェクトにインストール), --force (既存の設定を上書き)。
CLIリファレンス
mnemos init # first-time setup
mnemos store "..." # store (auto-pipeline)
mnemos search "auth" # hybrid search
mnemos list --project myapp # list memories
mnemos get <id> # fetch by id
mnemos update <id> --content "..." # update
mnemos delete <id> # soft delete
mnemos relate <src> <tgt> --type supersedes # typed relation
mnemos stats # storage + quality stats
mnemos maintain # decay + stale + GC
mnemos serve # MCP server (stdio)
mnemos version
# Autopilot setup
mnemos setup claude | cursor | kiro | gemini-cli [--global] [--force]
# Passive autopilot daemon
mnemos autopilot status
mnemos autopilot run [--dry-run] [--project <id>]
mnemos autopilot report [--project <id>]
# Backfill
mnemos backfill summaries --project <id> [--dry-run] [--limit N]
# Hook subcommands (called by clients, not manually)
mnemos hook session-start
mnemos hook prompt-submit
mnemos hook session-endmnemosではないもの
チャットボットメモリSaaSではありません。 カスタマーサポートボットでのユーザー設定の記憶にはMem0を使用してください。
時間的ナレッジグラフデータベースではありません。 ビジネス事実に関する有効/無効の推論にはZepを使用してください。
クラウド製品ではありません。 mnemosクラウドは存在しません。今後もありません。
フレームワーク固有ではありません。 MCPネイティブです。MCPを話すあらゆるものと連携します。
Mnemosは1つのことだけを行います：エージェントに、勝手にコンパイルされるナレッジベースを与えること。
ロードマップ
ROADMAP.mdを参照してください。要約：
v1.1.1 (リリース済み): フル自動パイプライン、MMRコンテキスト構築、ファイル対応取得、パッシブ自動操縦デーモン、ベンチマークフレームワーク
v1.2 (次期): 公開価値ベンチマーク（ドッグフーディング）、npmラッパー、デモGIF、HNローンチ
v1.3 (計画中): git経由のチームメモリ — チームメイトの知識を共有する
.mnemos/shared/v2.0+ (未定): プロジェクト横断的なメモリスコープ、メモリ圧縮、ユーザーフィードバック主導の改善
コミュニティ
ライセンス
MIT
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/s60yucca/mnemos'
If you have feedback or need assistance with the MCP directory API, please join our Discord server