Labsco
Nic9dev logo

Chronica

from Nic9dev

Persistent memory MCP server for Claude Desktop — remembers context, time, and topics across sessions

🔥🔥🔥✓ VerifiedFreeAdvanced setup
#automation#database#git#maps

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."

What is Chronica?

Chronica is a Model Context Protocol (MCP) server that gives Claude Desktop persistent, structured memory across sessions.

When you start a new conversation, Claude calls chronica_compose_opening with the current project name — and greets you with awareness of:

  • ✅ The current time (PC local timezone, auto-detected)
  • ✅ Up to five recent project-scoped memory entries (title preview, kind, recency — not full body text)
  • ✅ Open question / action items from that slice, called out for follow-up

Each user turn can also sync lightweight time/recency JSON via chronica_session_tick. Without the project argument on compose_opening, memories from other projects can mix in — the tool descriptions require always passing it (or confirming the name with list_threads first).

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

Chronicaとは？

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

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

Features / 機能

ToolDescription
compose_opening会話開始時に現在時刻・指定 project の直近5件・継続中（question/action）の要約テキストを生成。project は必須想定（混入防止）
session_tick各ターン用の軽量JSON（現在時刻・「何日ぶり」・直近トピック）。MCPはプッシュ不可のため毎ターン呼び出し推奨
save_entry会話内容をClaudeが自動保存（メモ・決定・タスクなど5種）
searchタグ・種別・スレッドで記憶を検索
timeline期間指定でタイムラインを取得
summarize日次・週次・決定事項のサマリー生成
get_last_seen最後に会話した時刻を取得
create_threadスレッド（会話トピック）を作成
list_threadsスレッド一覧を取得
get_thread_infoスレッドの詳細情報を取得

Curation UI（キュレーション画面）

Streamlit製の管理UIで、蓄積した記憶を整理できます。

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

📸 Screenshots

Curation UI — Memory management dashboard

Curation UI

Claude Desktop — Automatic tool invocation

Claude Desktop Tools

Claude Desktop — Memory saved and personalized response

Claude Desktop Memory

Architecture / アーキテクチャ

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.

Roadmap

Phase 2（近日予定）

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

Phase 3（将来）

  • クラウド同期（Supabase + E2EE）
  • 複数デバイス対応

Phase 4（将来）

  • SaaS化・マルチテナント対応

Author / 作者

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