Chronica

A persistent memory layer for Claude Desktop via MCP
Claude Desktopに長期記憶を与えるMCPサーバー

"AI conversations forget everything when the session ends.
Chronica remembers — so Claude can pick up right where you left off."

Chronica is aModel Context Protocol (MCP) serverthat gives Claude Desktop persistent, structured memory across sessions.

When you start a new conversation, Claude callschronica_compose_openingwith thecurrent project name— and greets you with awareness of:

- ✅ The current time (PC local timezone, auto-detected)
- ✅ Up to five recentproject-scopedmemory entries (title preview, kind, recency — not full body text)
- ✅ Openquestion/actionitems from that slice, called out for follow-up

Each user turn can also sync lightweight time/recency JSON viachronica_session_tick. Without theprojectargument oncompose_opening, memories from other projects can mix in — the tool descriptions require always passing it (or confirming the name withlist_threadsfirst).

No more "I don't have context from previous sessions." Chronica solves this at the architecture level.

Chronicaは、Claude Desktopに会話をまたいだ記憶を持たせるためのMCPサーバーです。

AIとの会話は、セッションが終わるとすべてリセットされます。
Chronicaを導入すると、Claudeが会話開始時にchronica_compose_openingでプロジェクト名付きの記憶サマリを読み込み、自然に続きから話せるようになります（明細は必要に応じてchronica_searchなどで取得）。

- 📋 記憶の一覧表示（種別・タグでフィルタ）
- 🗑️ 不要な記憶の削除（編集不可・削除のみ）
- 📊 トークン使用量の可視化（TOP 10・使用率）

Curation UI — Memory management dashboard

Claude Desktop — Automatic tool invocation

Claude Desktop — Memory saved and personalized response

Claude Desktop (Sonnet) │ MCP Protocol (STDIO) ▼ Chronica MCP Server (Python) └── src/chronica/ ├── tools.py # 10 MCP tools ├── opening.py # Context generation ├── summarize.py # Summary generation ├── store.py # SQLite persistence └── timeparse.py # Relative time parsing │ SQLite ▼ data/chronica.sqlite3

Design philosophy: Chronica is the single source of truth for time and memory structure. Claude acts purely as the interface — preventing hallucination by trusting only Chronica's structured output.

- Python 3.10+
- Claude Desktop(with MCP support)
- Windows / macOS

# Windows (PowerShell) .\setup.ps1 # Windows (cmd) setup.bat

# macOS / Linux chmod +x setup.sh ./setup.sh

git clone https://github.com/Nic9dev/Chronica.git cd Chronica

python -m venv .venv # Windows .venv\Scripts\activate # macOS source .venv/bin/activate

{ "mcpServers": { "chronica": { "command": "C:/path/to/Chronica/.venv/Scripts/python.exe", "args": ["C:/path/to/Chronica/run_server.py"], "env": { "PYTHONPATH": "C:/path/to/Chronica/src" } } } }

⚠️C:/path/to/Chronicaの部分はご自身の実際のパスに書き換えてください。
⚠️ Windowsでは/を使ってください（\は不可）。

5. Restart Claude Desktop / Claude Desktopを再起動

設定後、Claude Desktopを再起動してください。
新しい会話を開始し、Claudeが自動で記憶を読み込むことを確認できます。

新しい会話を始めると、Claudeがchronica_compose_openingを呼び出してコンテキストを読み込みます。呼び出し時はprojectに現在のプロジェクト名を渡すのが前提です（不明ならchronica_list_threads等で確認）。状況確認・記憶確認の依頼では、他ツールより先に本ツールを呼ぶよう MCP 側の説明で指示しています。

チャットの「+」ボタンまたは「/」でメニューを開き、「コネクタ」から Chronica をオン/オフできます。

- ON: 記憶の保存・呼び出し・時間認識が自動で行われます。
- OFF: その会話では Chronica のツールは利用されません。記憶を使わない一時的な相談などに。

- 記憶の保存: 通常通り会話するだけ。Claudeが自動で重要な情報を保存します。
- 記憶の検索: 「先週決めたことを教えて」など自然に聞くだけでOK。
- キュレーションUI: 記憶が溜まってきたら、以下で整理できます。

# Windows (PowerShell) .\run_curation.ps1 # Windows (cmd) run_curation.bat # または python -m streamlit run app_curation.py

- 会話開始:chronica_compose_openingではproject="..."を必ず渡す（別プロジェクトの記憶が混ざるのを防ぐ）。名前が曖昧ならchronica_list_threadsで確認してから呼ぶ。
- 詳細ログ:compose_openingは直近5件の要約のみ。長い作業ログは続けてchronica_searchをproject（必要ならタグvolN）で呼ぶ。

新しい会話（vol.2、vol.3 など）を始めるときは、例えば次のように伝えると 前回の作業内容をChronicaから正確に引き出せます。

chronica_searchを project「プロジェクト名」・タグ「vol2」で呼んで、 前回の作業内容と待ち事項を確認して。

⚠️ 「前回の作業を確認して」だけだと、ClaudeがChronicaではなく 自分の会話履歴を参照してしまうことがあります。compose_openingのprojectと、search の project / タグを明示するのがポイントです。

- 重複記憶の自動検出（TF-IDF + コサイン類似度）
- バッチ削除機能（複数選択）
- 全文検索
- エクスポート機能（JSON / CSV）

Nic9（にく９）
プログラミング未経験からAIと共に独学で複数のシステムを構築。
Chronicaは「AIと長く付き合い続けるための、個人的な基盤」として生まれました。

Issues and PRs are welcome!
バグ報告・機能要望はIssuesからどうぞ。

An MCP server for integrating with the Claude Desktop application on macOS. Requires the Claude Desktop app to be installed and configured.