CC-memory
Claude Code 專案記憶同步系統 - 跨設備、按專案隔離的智能記憶管理
特色
- 🧠 智能記憶萃取 - 使用 Claude 自動分析和摘要 session 內容
- 📁 專案隔離 - 每個專案獨立的記憶空間，互不干擾
- ☁️ 雲端同步 - PostgreSQL 後端，多台電腦自動同步
- 🔍 關鍵字搜尋 - 快速找到相關記憶
- 🎯 記憶分類 - Session 記憶與 Decision 決策分開管理
- 🔌 MCP 標準 - 標準 MCP 協議，與 Claude Code 無縫整合
快速開始
1. 安裝
# Clone 專案
git clone https://github.com/yourusername/CC-memory.git
cd CC-memory
# 安裝依賴
npm install
# 建置
npm run build2. 設定資料庫
在 Zeabur 或其他服務建立 PostgreSQL 資料庫，然後執行 migration：
# 設定環境變數
export DATABASE_URL=postgresql://user:password@host:5432/cc_memory
# 推送 schema 到資料庫
npx drizzle-kit pushSchema 真相來源：src/db/schema.ts（Drizzle ORM）。sql/migrations/目錄放drizzle-kit generate產出的版本化 SQL，禁止手寫CREATE TABLE或 SQL function 維護。舊有sql/schema.sql（Supabase 版） 已於 v0.2 Phase 0 刪除。
3. 配置 Claude Code
# 加入 MCP server
claude mcp add cc-memory \
-e DATABASE_URL=your-connection-string \
-- node /path/to/CC-memory/build/index.js4. 安裝 Skills
cp skills/*.md ~/.claude/skills/使用方式
儲存記憶
/save-memoryClaude 會分析對話內容，讓你預覽後儲存到資料庫。
載入記憶
/load-memory載入當前專案的記憶上下文和近期進度。
搜尋記憶
Claude 會自動使用 cc_memory_search 工具搜尋相關記憶。
搜尋關於 "authentication" 的記憶列出專案記憶
列出這個專案的所有記憶MCP Tools
| Tool | 說明 |
|---|---|
cc_memory_save | 儲存記憶到資料庫 |
cc_memory_search | 關鍵字搜尋記憶 |
cc_memory_list | 列出專案的記憶 |
cc_memory_get | 取得單一記憶詳情 |
cc_memory_stats | 取得專案統計 |
cc_memory_delete | 刪除指定記憶 |
架構
Claude Code Session
↓
/save-memory skill (Claude 分析摘要)
↓
cc_memory_save (MCP tool)
↓
PostgreSQL (Drizzle ORM)
↓
cc_memory_search / cc_memory_list
↓
注入相關 context配置選項
環境變數：
| 變數 | 說明 | 必填 |
|---|---|---|
DATABASE_URL | PostgreSQL 連線字串 | ✅ |
開發
# 開發模式
npm run dev
# 建置
npm run build
# Drizzle Studio
npx drizzle-kit studio測試
Integration tests（tests/db/v02-tdd.test.ts）要真 PostgreSQL + pgvector 才能跑，不 silent skip。本機第一次跑測試前：
# 啟動本機 test PG（pgvector/pg16，port 5433）
docker compose -f docker-compose.test.yml up -d
# 推 schema 進 test DB
npx drizzle-kit push --config drizzle.test.config.ts
# 跑測試
npm testCI 或用現成 test PG 時，設 TEST_DATABASE_URL 跳過本機 docker：
export TEST_DATABASE_URL=postgres://user:pass@host:port/db
npm test若 test PG 不可用，測試會 fail-loud 並印出上面的指令作為提示。Embedding 相關測試不依賴 GEMINI_API_KEY（用 vi.mock 隔離，不會打真 Gemini API）。
License
MIT License - 自由使用、修改、分享