CPersona ドキュメント¶
CPersona は MCP サーバーです。Claude Code、Codex をはじめとする MCP クライアントに、セッションをまたいで残る記憶を与えます。
対象: CPersona 2.6.x。 このサイトが正式ドキュメントです。README や同梱 skill の記述とこのサイトが食い違う場合はサイトが優先で、その食い違い自体が報告に値するバグ です。
翻訳について: 正本は英語版です。日本語版が古い場合や存在しないページは英語版を参照してください (未翻訳ページは自動的に英語で表示されます)。
目的別ガイド¶
-
はじめに
インストールし、MCP クライアントに登録し、接続を検証します。
-
アーキテクチャ
記憶がどこに保存され、3 つの検索器がどう探し、融合 → ゲート → 反転のパイプラインが何をするか。図付きです。
-
ツール一覧
全ツールを目的別にまとめています。名前から想像できない挙動をするツールは、その理由を説明する契約へリンクしています。
-
挙動契約
依存してよい挙動です。ここを変えることは、好みの変更ではなくバグとして扱います。
-
設定リファレンス
全環境変数と既定値、そして HTTP トランスポートが応答するための要件。
-
運用 Runbook
バックアップ、劣化検知、recall を調整する順序、日本語コーパス、保守の周期。
-
2.6 への移行
2.5.x のストアを 2.6.0 へ一度に移行する手順: バックアップ、最初の起動で移行されるもの、後で作るもの、戻し方。
-
FAQ
運用者からよく来る質問への短い回答。それぞれ詳細のあるページへリンクします。
-
品質保証
リリースがどう検査されるか: 監査ラウンド、バグ登録簿、構造ゲート、変異証明。
-
設計と研究
各挙動がどう決まったか、ロードマップ、他のプロジェクトでも採用できる標準、その下にある実測。CPersona を使うだけなら必要ありません。
仕組み¶
記憶はローカルの SQLite ファイル 1 つに保存されます。recall はそれを 3 通り (vector・FTS5・keyword) で検索し、ランクまたは相対スコアで融合します。
サーバーは LLM に一切依存しません: 生成モデルを呼びません。ただし、これは次の 2 つを意味しません。
- 常に無料とは限りません。
EMBEDDING_MODE=apiでは、埋め込みリクエストごとに課金されます (既定のエンドポイントは OpenAI)。自前の埋め込みサーバーを指すhttpモードでは課金されません。 - どの環境でも同じとは限りません。 recall は品質ゲートが較正済みであれば決定論的です。較正はコーパスをランダムに標本して行うため、同じデータを持つ 2 つの環境が別のゲートに落ち着くことがあります。
3 つの記憶タイプ¶
- 宣言的記憶 — 個別の事実・決定・ルール (
store/recall)。 - エピソード記憶 — セッション要約 (
archive_episode)。有効にした時のエピソード境界ペナルティ の駆動源でもあります。 - プロフィール — 蓄積されたユーザー/プロジェクト属性 (
update_profile)。スコアリング上の注意 があります。
AI エージェント向け¶
このサイトの機械可読索引を llms.txt で公開しています。同梱の
cpersona-memory skill
はエージェントに store / recall / archive の日常ワークフローを教え、正確な詳細はこのサイトへリンクで戻します。
支援について¶
CPersona は MIT ライセンスで、この先も変わりません。役に立って、この作業が続いてほしいと思っていただけたなら、支援のページをご覧ください。支援が買うもの・買わないものと、お金のかからない助け方を書いています。