convez.ai
MCP ServerProdutividadeAvançado
hahayo

CC-memory - Sistema de Memória de Projetos

hahayo/CC-memory

Memória persistente e sincronizada para projetos Claude Code entre dispositivos

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server para sincronização inteligente de contexto e decisões entre sessões do Claude Code, com armazenamento isolado por projeto em PostgreSQL. Extrai automaticamente aprendizados, progresso e decisões técnicas para reutilização em múltiplos dispositivos.

Instalação

$npx convez-ai hahayo/CC-memory

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 dias
Versão
—
Issues abertas
12
Contribuidores
2

Casos de uso

  • Retomar projetos longos sem perder contexto técnico acumulado
  • Sincronizar decisões arquiteturais entre desenvolvedores da mesma equipe
  • Manter histórico de sessões com extração automática de insights importantes

Veredito

Ferramenta sofisticada para equipes que usam Claude Code em fluxos contínuos. Reduz drasticamente a repetição de contexto, mas requer setup de PostgreSQL e compreensão do protocolo MCP. Vem pronta para produção com testes integrados.

README

A tradução para o português deste README ainda está na fila.

CC-memory

Claude Code 專案記憶同步系統 - 跨設備、按專案隔離的智能記憶管理

License: MIT

特色

  • 🧠 智能記憶萃取 - 使用 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 build

2. 設定資料庫

在 Zeabur 或其他服務建立 PostgreSQL 資料庫,然後執行 migration:

# 設定環境變數
export DATABASE_URL=postgresql://user:password@host:5432/cc_memory

# 推送 schema 到資料庫
npx drizzle-kit push

Schema 真相來源: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.js

4. 安裝 Skills

cp skills/*.md ~/.claude/skills/

使用方式

儲存記憶

/save-memory

Claude 會分析對話內容,讓你預覽後儲存到資料庫。

載入記憶

/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_URLPostgreSQL 連線字串(project DB)✅
DATABASE_URL_PERSONAL獨立 personal DB 連線字串(Phase 3;見 docs/personal-hub/decisions/ADR-001-phase3-separate-db.md)forced personal instance 必填;其他 instance 禁配(偵測到 warn + 拒載入該 URL)

開發

# 開發模式
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 test

CI 或用現成 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 - 自由使用、修改、分享

Ver o original no GitHub

Bom para

Relacionados