MemoCat — Shared AI Memory

Montycat MCP - AI エージェントのための共有メモリ

AI エージェントに永続的で検索可能なメモリを提供する、セルフホスト可能な MCP サーバーです。 Claude、Codex、Cursor、その他あらゆる Model Context Protocol クライアントが 1 つのメモリに書き込み、互いのメモリを読み取ります。

• チャットをまたいで残るメモリ。 決定事項、好み、プロジェクトのコンテキストが次のセッションに引き継がれます。
• 1 つのメモリを、多数のエージェントで。 使用するすべての MCP クライアントが同じ事実に基づいて動作します。
• 意味・キーワード・その両方で思い出す。 ベクトル検索は表現が異なる場合でもメモリを見つけ、BM25 は正確な識別子を捕捉し、ハイブリッドモードはその 2 つを融合します。完全一致キーとメタデータによる検索も可能です。
• あなたのものです。 サーバー、エンジン、埋め込みはすべてお使いのマシン上で動作します。ホスト型のメモリサービスも、クラウドの埋め込み API も不要です。

インストール

Claude Desktop — montycat-mcp.mcpb をダウンロードし、Claude Desktop にドラッグしてください。Python は不要です。このリンクは常に 最新リリースを提供します。各リリース には、バージョン名付きのコピーと、それを検証するための .sha256 も含まれています。

Claude Code — uv をインストールしてから、次を実行します。

/plugin marketplace add MontyGovernance/montycat-mcp
/plugin install montycat-mcp@montygovernance

/mcp で montycat サーバーが接続されていることを確認できます。

Codex、Cursor、その他の MCP クライアント — クライアントの stdio 設定を uvx montycat-mcp に向けてください（Python 3.10+）。Codex の場合:

codex mcp add montycat -- uvx montycat-mcp

エンジン

メモリは Montycat Semantic エンジンに保存されます。 Montycat MCP はローカルのエンジンを自動的に起動するため、ほとんどの方はここから先を読む必要はありません。

すでに運用しているエンジンを指定する場合:

export MONTYCAT_URI="montycat://memory-agent:password@localhost:21210/memories"
export MONTYCAT_TLS=true   # remote engines only

または、Docker で自分で起動する場合:

docker run -d --name montycat -p 21210:21210 -p 21211:21211 \
  -e MONTYCAT_SUPEROWNER=admin -e MONTYCAT_PASSWORD=change-me \
  -v montycat_data:/var/lib/.montycat \
  montygovernance/montycat:semantic

Apple Silicon では代わりに arm64-semantic タグを使用してください — semantic は amd64 イメージであり、エミュレーション下ではクラッシュします。ポート 21211 はライブメモリウォッチを提供します。

使い方

エージェントに普段どおり話しかけてください。エージェントがツールを選びます。

チームが請求サービスに PostgreSQL を選んだことを覚えておいて。

請求データベースについて何を決めたっけ？

これを共有の engineering スコープに保存して。

scope はメモリがどこに保存されるかを決めます — alice はプライベート用、engineering は チーム用、shared は共通用途です。これは名前空間であり、セキュリティ境界ではありません。本当の 分離が必要な場合は、各 MCP サーバーに最小権限の Montycat 認証情報を個別に与えてください。

ツール

用途	ツール
保存	montycat_remember、montycat_remember_bulk、montycat_update、montycat_forget
検索	montycat_semantic_search、montycat_recall、montycat_list_memories
スキーマの確認	montycat_list_enforced_schemas — 構造化書き込みやフィルタ付き検索の前に、フィールド名とデータ型を確認します
コラボレーション	montycat_await_memory_change — ポーリングせずに、別のエージェントの書き込みを待ちます
名前空間	montycat_list_keyspaces、montycat_create_keyspace、montycat_update_cache、montycat_remove_keyspace
管理	セマンティックインデックス、スナップショット、ポリシー関連のツール — プラグインガイドを参照してください

永続的な名前空間の場合、cache は MB 単位の容量であり、compression は montycat_create_keyspace によって選択されます。圧縮方式はキースペースの作成後には変更できません。 別の設定を使用するには、新しいキースペースに移行してください。 キャッシュ容量は後から montycat_update_cache で変更できます。

破壊的なツールはそのように宣言されているため、クライアントの確認プロンプトが適用されます。

設定

変数	目的
MONTYCAT_URI	接続文字列: montycat://user:password@host:port/store
MONTYCAT_TLS	リモート TLS エンジンの場合は true
MONTYCAT_TLS_VERIFY	オプション: プラットフォームのトラストストアで検証する場合は true
MONTYCAT_TLS_CERTIFICATE_PATH	オプション: 正確な証明書ピンニング用の PEM 証明書パス
MONTYCAT_TLS_CERTIFICATE_FINGERPRINT	オプション: ピンの代替としての SHA-256 証明書フィンガープリント

3 つの検証設定はすべてオプションです。MONTYCAT_TLS=true のみの場合、 MCP は従来の暗号化されるが検証されない動作を維持します。TLS が未設定または false の場合、既存の平文設定は変更されません。 | MONTYCAT_DEFAULT_KEYSPACE | メモリ名前空間。デフォルトは memory | | MONTYCAT_SCOPE | 呼び出しでスコープが省略された場合のデフォルトスコープ | | MONTYCAT_AUTO_PROVISION | 初回使用時に許可されたスコープを作成します。デフォルトは true | | MONTYCAT_AUTOSTART | すでに実行中のエンジンを必須にする場合は off |

Compose のセットアップと変数の完全な一覧: compose.yaml および プラグインガイド。

詳細

変更履歴 · プライバシー · イシュー · ドキュメント · Docker Hub

既存の MemoCat インストールは引き続き動作します: memocat-mcp、MEMOCAT_*、および memocat:// は依然としてサポートされています。新しいセットアップでは Montycat の名前を使用してください。

MIT