mnema

Mnema

AI エージェント向けのローカルファーストで形式検証済みのメモリー — MCP 経由で、1 つの共有ストアをすべてのクライアントから利用できます。

エージェントの知能は研究機関から借りるものでも、メモリーはあなた自身のものであるべきです。 Mnema は、エージェントが学んだことを保存する、単一の永続ストアです。行動する前に consult で参照し、永続的な事実を learn で記録し、related グラフをたどり、最近の項目を list で確認できます。データはマシン上の ~/.mnema に保存され、保存先を指定しない限り外部に送信されることはありません。

• 検証済みエンジン。 組み込みのエングラムデータベースは形式的に仕様化され、機械的に検査されています（250 件以上のテストで検証されたプロパティカタログ、網羅的な CRDT 適合性モデルチェッカー、Kani 証明、TLA⁺ モデル）。リリースされたすべてのバイナリは、対象のコミットでこの検証を通過しています。
• ローカルファースト。 ~/.mnema に保存される、オープンな追記専用のセグメント形式です。クラウドもアカウントも不要です。
• 1 つのストアを、すべてのクライアントから。 Claude Code、Claude Desktop、Cursor、スクリプト、CI がすべて同じメモリーを利用します。想起は、語彙検索とグラフ上の拡散活性化（オプションのセマンティック埋め込みも利用可能）を組み合わせ、すべての回答に信頼度の範囲を正直に示します。

このリポジトリでは、公開リリースバンドル（.mcpb）とビルド済みバイナリを配布しています。製品、ドキュメント、ダウンロードは mnema.zimac.ai にあります。

インストール

MCP Registry から（推奨）

Mnema は公式の MCP Registry に ai.zimac/mnema として公開されています。レジストリに対応したクライアントなら、名前を指定してインストールできます。このリポジトリのリリースからプラットフォーム用の .mcpb バンドルを取得し、fileSha256 を検証します。

.mcpb バンドル（手動）

最新リリースからプラットフォーム用のバンドルをダウンロードし、MCP バンドル対応クライアントで開いてください（例：Claude Desktop → 拡張機能）。

プラットフォーム	アセット
macOS（ユニバーサル）	mnema-<version>-macos-universal.mcpb
Linux（x86_64）	mnema-<version>-linux-x86_64.mcpb

.mcpb は manifest.json、mnema バイナリ、この README をまとめた ZIP です。リリース前に、それぞれドライランで検証されます（バンドル内のバイナリが MCP の initialize ハンドシェイクを完了します）。

ヘッドレスバイナリ（curl | sh）

エージェント、スクリプト、CI 向け — スタンドアロンの mnema バイナリをインストールします。

curl -fsSL https://mnema.zimac.ai/install.sh | sh

（macOS ユニバーサル版と Linux x86_64 版はビルド済みです。それ以外はソースからビルドします。macOS の GUI アプリは mnema.zimac.ai から別途ダウンロードできます。）

エージェントにメモリーを追加する

claude mcp add mnema -- mnema mcp

設定はこれだけです。mnema mcp は共有ローカルストアが起動していない場合に自動で起動し、セッションで 4 つのツール（行動前に検索する consult、永続的な事実を記録する learn、グラフ上の隣接項目をたどる related、一覧表示する list）を利用できます。任意の MCP クライアントで動作します。汎用設定は次のとおりです。

{ "mcpServers": { "mnema": { "command": "mnema", "args": ["mcp"] } } }

共有ストア／チームストアを指定する

同じバイナリで、ローカルストアの代わりにリモート Mnema（トークンで保護された mnema serve またはホスト型の学習データポッド）に接続できます。

MNEMA_URL=https://memory.example.com MNEMA_TOKEN=<secret> mnema mcp

ループバック以外の URL を指定すると、自動起動は行われず、認証済みのブリッジとしてのみ動作します。

設定

環境変数	デフォルト	内容
MNEMA_DATA_DIR	~/.mnema	ストアの保存場所
MNEMA_URL	http://127.0.0.1:7077	CLI／MCP ブリッジの接続先ストア
MNEMA_TOKEN	—	リモートストア用のベアラー認証情報

リンク

• 製品とダウンロード： https://mnema.zimac.ai
• レジストリエントリー： https://registry.modelcontextprotocol.io の ai.zimac/mnema
• リリース（.mcpb とバイナリ）： https://github.com/Zimac-AI/mnema/releases

---

Mnema は Zimac のプロジェクトです。