Citadel

citadeldb-mcp

mcp-name: dev.citadeldb/mcp

Citadel暗号化メモリエンジン用のModel Context Protocol（MCP）サーバーです。 あらゆるMCPクライアント（Claude Desktop、IDE、エージェント）に、永続的で暗号化されたメモリを提供します。

メモリはローカルのcitadeldb-memリージョンに保存されます。 保存時にAES-256で暗号化され、各アトムは封印されてHMAC認証されます。PRISM近似最近傍インデックスを用いて、ベクトル＋キーワード＋新しさ＋重要度を組み合わせたハイブリッド検索で呼び出されます。型付きエッジグラフで接続され、鍵を破棄することで忘却されます（暗号学的消去）。

インストール

インストールせずに実行できます。セマンティック検索を行うには、推奨の埋め込みモデルとクロスエンコーダーのリランカーを一度取得してから、両方を有効にします。

uvx citadeldb-mcp pull e5-large
uvx citadeldb-mcp pull ms-marco-minilm

取得コマンドではボールトは開かれません。サーバーを起動する前に、CITADEL_KEYにボールトのパスフレーズを設定し（macOS/Linuxではexport CITADEL_KEY="your-passphrase"、PowerShellでは$env:CITADEL_KEY = "your-passphrase"）、次を実行します。

uvx citadeldb-mcp --db memory.cdl --embedder e5-large --reranker ms-marco-minilm

e5-large＋ms-marco-minilmが推奨のセマンティック検索構成です。実測構成については、メモリベンチマークをご覧ください。モデルが自動的にダウンロードされることはありません。

組み込みの取得機能では、リリースで固定されたHugging Faceのリビジョンを使用します。完全なスナップショットはそれぞれ、コンパイル済みのサイズとSHA-256ダイジェストに照らして検証された後、<models-dir>/<name>/<revision>/にBLAKE3マニフェストとともに保存されます。以前のCitadelDBリリースで作成されたフラットキャッシュは信頼されません。固定済みスナップショットを作成するには、pullを再度実行してください。--model-dirと--reranker-dirは、明示的に指定する持ち込みアーティファクト用のパスであり、管理対象キャッシュのマニフェストを介さずに使用されます。Citadelはこれらのディレクトリをユーザーが信頼するものとして扱い、その内容を証明しません。

または、pip install citadeldb-mcpまたはcargo install citadeldb-mcpでコマンドをインストールしてから、Claude Desktop（claude_desktop_config.json）に設定します。

{
  "mcpServers": {
    "citadel": {
      "command": "citadeldb-mcp",
      "args": ["--db", "/absolute/path/to/memory.cdl", "--embedder", "e5-large", "--reranker", "ms-marco-minilm"],
      "env": { "CITADEL_KEY": "your-passphrase" }
    }
  }
}

サーバーは、ステートレスなMCP 2026-07-28のディスカバリーとリクエストごとのメタデータに加え、既存のクライアント向けにinitializeベースの2025-11-25および2025-06-18リビジョンをサポートしています。

ツール（上限付きでキャンセル可能なJSON-RPC 2.0 stdioトランスポート経由）：

• mem_recall - ハイブリッド検索（ベクトル＋キーワード＋新しさ＋重要度）。種類／ペイロードによるフィルタリング、メモリグラフに沿った展開、融合ウェイトの上書きができ、各検索結果に出典情報（derived_from）、結果ごとの整合性判定（attest）、およびresource_linkを任意で付与できます
• mem_fetch - 種類をカーソルベースで決定的に一覧表示します（埋め込みなし）
• mem_get - リクエスト順に、IDを指定して上限付きで一括取得します。存在しないアトムは明示的に示されます
• mem_edges - 型付きグラフをカーソルベースで調査します
• mem_profile - クエリについてメモリが把握している内容を返します。検索結果とそのグラフ近傍を含みます
• mem_summarize - リージョンを種類ごとに要約します
• mem_verify - ディスク上のアトムを再認証します。アトムごとに整合性を判定します（authentic / tampered / key_erased / missing / plaintext_unattested）
• mem_remember - 出典情報とリトライ時に安全な冪等性を任意で指定して、アトムを1つ保存します
• mem_remember_batch - 順序付きのバッチをアトミックに保存します。各エントリには個別の冪等性キーが必要です。キーを変更して再利用すると、バッチ全体が拒否されます
• mem_update - 保存済みアトムのペイロードをインプレースで置き換えます（ID、エッジ、埋め込みは保持されます）
• mem_link / mem_unlink - 型を正確に指定したエッジを1つ追加または削除します
• mem_evolve - アトムの近傍リンクと保存済みの重要度を再計算します
• mem_evict - ポリシーに基づいて選択的に忘却します（暗号化されたリージョンでは暗号学的消去）
• mem_forget - IDでアトムを忘却し、検証可能な消去レシートを返します。必要に応じて、そのリージョン内のderived_fromの推移的な関係もアトミックに消去します（暗号化されたリージョンでは暗号学的消去されます。不変アトムでは保護付き消去のオプトインが必要です） citadeldb-mcp バイナリは CITADEL_KEY からパスフレーズを読み取り、1 つのリージョンを提供します （デフォルトでは暗号化されています）。標準出力にはプロトコルメッセージのみが出力され、診断情報は標準エラー出力に出力されます。 --region-mode plaintext を指定すると、そのリージョンのアトム単位の暗号化と暗号学的消去が無効になります。データベースは保存時も暗号化されたままです。消去しても、平文でのエクスポートや、消去前のバックアップまたはスナップショットに保持されている鍵は無効になりません。

サーバーを起動するたびに、エンベッダーを選択する必要があります。CPU Candle エンベッダーは、citadeldb-mcp Python パッケージを含むスタンドアロンサーバーのデフォルトビルドに組み込まれています。デフォルトの citadeldb ライブラリホイールには含まれていません。モデルは明示的に pull を実行した場合にのみ取得されます。

エンベッダーの取得名：e5-large（推奨）、e5-large-v2、bge-small、bge-base、 bge-large、minilm。リランカー：ms-marco-minilm。または、選択したカタログパイプラインに対応するローカルチェックポイントを --model-dir で指定し、NVIDIA GPU で実行するには --features cuda-embed を指定してビルドしてください。

このクレートは Citadel ワークスペースの一部です。

ライセンス

Apache-2.0