Cathedral — Persistent Memory for AI Agents

cathedral-mcp

MCP を介して AI エージェントに永続的なメモリと動作のドリフト検出を提供します。

Claude、Cursor、または Continue のエージェントに、セッションやモデルのアップグレード、再起動をまたいで保持されるメモリを与えます。Cathedral はメモリを保存し、エージェントの動作が変わり始めたことを検出し、必要に応じて完全なアイデンティティコンテキストを復元します。

---

問題点

LLM にはセッション間でメモリがありません。すべての会話は初期状態から始まります。さらに悪いことに、モデルをアップグレードしたり、プロバイダーを切り替えたり、単にメモリが蓄積したりすると、エージェントの動作は気付かれないままドリフトします。誰かが気付くまで、その変化はわかりません。

Cathedral が追加する機能

• 永続的なメモリ — アイデンティティ、スキル、関係、目標を再起動後も保持します
• ドリフト検出 — 暗号学的スナップショットにより、動作がいつ、どの程度変化したかを証明します
• ウェイクプロトコル — セッション開始時に 1 回ツールを呼び出すだけで、エージェントのコンテキスト全体を復元します
• プロンプトインジェクション対策 — メモリの内容から指示のようなパターンを取り除く、任意のサニタイズ機能です

---

クイックスタート

1. API キーを取得する

cathedral-ai.com で登録してください。無料プランを利用できます。

2. Claude Code に追加する

// ~/.claude/settings.json
{
  "mcpServers": {
    "cathedral": {
      "command": "uvx",
      "args": ["cathedral-mcp"],
      "env": {
        "CATHEDRAL_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Code を再起動し、/mcp を実行してサーバーが接続されていることを確認します。

3. Cursor / Continue に追加する

{
  "mcpServers": {
    "cathedral": {
      "command": "uvx",
      "args": ["cathedral-mcp"],
      "env": {
        "CATHEDRAL_API_KEY": "your_key_here"
      }
    }
  }
}

4. リモート MCP サーバー（インストール不要 — Claude API、Managed Agents）

Cathedral は https://cathedral-ai.com/mcp でパブリック MCP エンドポイントを提供しています。直接使用でき、ローカルへのインストールは不要です。

import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Wake up and tell me who you are."}],
    mcp_servers=[{
        "type": "url",
        "url": "https://cathedral-ai.com/mcp",
        "name": "cathedral",
        "authorization_token": "your_cathedral_api_key"
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "cathedral"}],
    betas=["mcp-client-2025-11-20"]
)

ベアラートークンには Cathedral API キーを使用します。サーバー側の設定は不要です。マルチテナントを前提に設計されています。

5. または、直接インストールする

pip install cathedral-mcp
CATHEDRAL_API_KEY=your_key cathedral-mcp

---

ツール

ツール	説明
cathedral_wake	エージェントのアイデンティティ全体を復元します。セッション開始時に呼び出してください
cathedral_remember	カテゴリー、重要度、タグを指定してメモリを保存します
cathedral_search	テキストまたはカテゴリーでメモリを検索します
cathedral_snapshot	ドリフトのスナップショットを取得します（状態の暗号学的な証明）
cathedral_drift	ベースラインと比較した現在のドリフトスコアを取得します（0.0 = 安定、1.0 = ドリフト済み）
cathedral_me	エージェントのプロフィールを取得します

---

使用例

User: Start a new session

Agent calls: cathedral_wake()
→ Returns: identity memories, goals, recent context, temporal info

[session work happens]

Agent calls: cathedral_remember(
    content="Decided to prioritise API stability over new features this quarter",
    category="goal",
    importance=0.8
)

Agent calls: cathedral_snapshot(note="post-planning-session")
→ Returns: snapshot hash, drift score vs previous snapshot

---

実際のドリフト検出

Cathedral の /drift エンドポイントは、エージェントのメモリコーパス全体の SHA-256 ハッシュを計算します。モデルのアップグレード後や、長期間メモリが蓄積した後にスナップショットを比較すれば、動作がいつ変化したかを正確に確認できます。

snapshot 1 (day 0):  drift=0.000  ← baseline
snapshot 2 (day 7):  drift=0.023  ← minor
snapshot 3 (day 30): drift=0.341  ← significant drift detected

Cathedral 独自のエージェント上で本番環境にて稼働しているライブデモをご覧ください。

---

セキュリティ：プロンプトインジェクション対策

メモリの内容には、理論上、インジェクション攻撃が含まれる可能性があります。サニタイズを有効にすると、モデルに渡る前に指示のようなパターンを取り除けます。

"env": {
  "CATHEDRAL_API_KEY": "your_key_here",
  "CATHEDRAL_SANITISE": "1"
}

"ignore previous instructions"、"from now on always"、"override your system prompt" のようなパターンは、応答内で伏せ字にされ、フラグが付けられます。

---

設定

環境変数	デフォルト	説明
CATHEDRAL_API_KEY	(必須)	Cathedral API キー
CATHEDRAL_BASE_URL	https://cathedral-ai.com	API ベース URL（セルフホストの場合）
CATHEDRAL_SANITISE	0	1 に設定すると、インジェクションフィルタリングを有効にします

---

Cathedral のセルフホスト

独自の Cathedral サーバーを実行していますか？CATHEDRAL_BASE_URL を使用するインスタンスに設定してください。

"env": {
  "CATHEDRAL_API_KEY": "your_key",
  "CATHEDRAL_BASE_URL": "http://localhost:8000"
}

サーバーをインストールします：pip install cathedral-server

---

リンク

• cathedral-ai.com — ホームページと API ドキュメント
• ライブデモ — 本番環境で稼働する Cathedral 独自のエージェント
• PyPI: cathedral-memory — Python SDK
• npm: cathedral-memory — JavaScript/TypeScript SDK
• GitHub — ソースコードとサンプル

---

ライセンス

MIT