{"_id":"claude-dev-memory","name":"claude-dev-memory","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"claude-dev-memory","version":"1.0.0","description":"MCP Server for Claude Code project memory - multi-block Core Memory (project/learnings/decisions) via Letta Cloud","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"claude-dev-memory":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"vitest","test:run":"vitest run","lint":"eslint src/","prepublishOnly":"npm run build"},"keywords":["mcp","claude","claude-code","letta","memory","ai","long-term-memory","development"],"author":{"name":"miles990"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/miles990/claude-dev-memory.git"},"bugs":{"url":"https://github.com/miles990/claude-dev-memory/issues"},"homepage":"https://github.com/miles990/claude-dev-memory#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.25.1"},"devDependencies":{"@types/node":"^20.19.27","typescript":"^5.3.0","vitest":"^1.6.1"},"engines":{"node":">=18.0.0"},"_id":"claude-dev-memory@1.0.0","gitHead":"64c6220f9bfb2b790f92f093d8bacb2ec7c8ee08","_nodeVersion":"24.5.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-cihU++GkAD2fPkdA4kpCi7mFRSmn11RN6seNPawWJMV/rwCcDnOlbUheJY4jsb5I07S056akj5FdRwNGqgthjg==","shasum":"2a53813f9747834ed650f83fd90429b591794470","tarball":"https://registry.npmjs.org/claude-dev-memory/-/claude-dev-memory-1.0.0.tgz","fileCount":78,"unpackedSize":97588,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCJ5Gfhe4h+UC/nvxGN7Vv70I2rOz0/fE528pmq9V4iAwIhAOzZl8trcC3UBHkACDA0o/ZmQTG9CSK2J4ynCGURGj4B"}]},"_npmUser":{"name":"miles990","email":"alexlee7171@gmail.com"},"directories":{},"maintainers":[{"name":"miles990","email":"alexlee7171@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/claude-dev-memory_1.0.0_1766557994516_0.6754738278649255"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-24T06:33:14.515Z","1.0.0":"2025-12-24T06:33:14.731Z","modified":"2025-12-24T06:33:14.974Z"},"maintainers":[{"name":"miles990","email":"alexlee7171@gmail.com"}],"description":"MCP Server for Claude Code project memory - multi-block Core Memory (project/learnings/decisions) via Letta Cloud","homepage":"https://github.com/miles990/claude-dev-memory#readme","keywords":["mcp","claude","claude-code","letta","memory","ai","long-term-memory","development"],"repository":{"type":"git","url":"git+https://github.com/miles990/claude-dev-memory.git"},"author":{"name":"miles990"},"bugs":{"url":"https://github.com/miles990/claude-dev-memory/issues"},"license":"MIT","readme":"# Claude Dev Memory\n\n為 Claude Code 開發工作流提供長期記憶功能的 MCP Server，透過 Letta Cloud API 實現跨 session 專案記憶。\n\n## 功能特色\n\n- **多區塊 Core Memory** - project / learnings / decisions（~2000 tokens）\n- **Archival Memory** - 完整 spec、commit 記錄、詳細文檔（無大小限制）\n- **專案導向** - 專為 Claude Code 開發工作流設計\n- **語意搜尋** - 透過向量搜尋找出相關記憶\n\n## 與官方 letta-memory-mcp 的差異\n\n| 面向 | 官方 letta-memory-mcp | claude-dev-memory |\n|------|----------------------|-------------------|\n| 目標用戶 | 通用 AI 應用 | Claude Code 開發者 |\n| Memory 結構 | 單一 human block | project / learnings / decisions |\n| Agent 策略 | 自動建立 per user | 指定現有 Agent |\n| 額外功能 | - | Token 計算、狀態檢查、類型標籤 |\n\n## 安裝\n\n```bash\nnpm install -g claude-dev-memory\n```\n\n或使用 npx：\n\n```bash\nnpx claude-dev-memory\n```\n\n## 配置\n\n### 1. 取得 Letta API Key\n\n1. 前往 [Letta Cloud](https://app.letta.com/)\n2. 註冊帳號並取得 API Key\n3. 建立 Agent 並記下 Agent ID\n\n### 2. 配置 Claude Code\n\n```bash\nclaude mcp add claude-dev-memory -s user -- npx claude-dev-memory\n```\n\n設定環境變數：\n\n```bash\n# 在專案 .env 或 shell profile 中\nexport LETTA_API_KEY=sk-let-xxxxx\nexport LETTA_AGENT_ID=agent-xxxxx\n```\n\n或使用 JSON 配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-dev-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"claude-dev-memory\"],\n      \"env\": {\n        \"LETTA_API_KEY\": \"your-api-key-here\",\n        \"LETTA_AGENT_ID\": \"agent-xxxxx\"\n      }\n    }\n  }\n}\n```\n\n## 工具說明\n\n### memory_status\n\n查看記憶系統狀態。\n\n```\n顯示：連線狀態、Core Memory 使用量、Archival 記錄數\n```\n\n### memory_recall\n\n讀取 Core Memory，恢復專案上下文。\n\n| 參數 | 說明 |\n|------|------|\n| block | 要讀取的區塊：all, project, learnings, decisions |\n\n### memory_update\n\n更新 Core Memory，記錄專案進度和決策。\n\n| 參數 | 說明 |\n|------|------|\n| block | 要更新的區塊：project, learnings, decisions |\n| content | 完整替換內容 |\n| append | 附加內容 |\n| auto_summarize | 超過限制時自動摘要（預設 false） |\n\n### memory_archive\n\n存入 Archival Memory，保存完整文檔。\n\n| 參數 | 說明 |\n|------|------|\n| content | 要存檔的內容 |\n| type | 內容類型：spec, commit, learning, decision |\n| tags | 標籤陣列 |\n\n### memory_search\n\n搜尋 Archival Memory，找出相關記錄。\n\n| 參數 | 說明 |\n|------|------|\n| query | 搜尋關鍵字 |\n| filter | 過濾類型：all, spec, commit, learning, decision |\n| limit | 回傳筆數上限（預設 5） |\n| min_relevance | 最低相關度（預設 0.7） |\n\n## MCP Resource\n\n### letta://memory/core\n\n被動讀取 Core Memory 內容，回傳 JSON 格式的完整記憶資料。\n\n## 使用情境\n\n### Session 開始時恢復上下文\n\n```\n使用 memory_recall 工具讀取 project 區塊\n```\n\n### 完成重要決策後記錄\n\n```\n使用 memory_update 工具更新 decisions 區塊\n```\n\n### 保存完整 spec 文檔\n\n```\n使用 memory_archive 工具，type 設為 spec\n```\n\n### 遇到類似問題時搜尋\n\n```\n使用 memory_search 工具搜尋相關記錄\n```\n\n## 記憶架構\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                     Core Memory                         │\n│  (小而重要，~2000 tokens，每次對話都會載入)              │\n│  ├── project: 專案概述、當前狀態、重點                   │\n│  ├── learnings: 學習紀錄、解決方案                       │\n│  └── decisions: 架構決策、設計選擇                       │\n└─────────────────────────────────────────────────────────┘\n                           │\n                           ▼\n┌─────────────────────────────────────────────────────────┐\n│                   Archival Memory                        │\n│  (大而完整，無限制，需要時搜尋取用)                       │\n│  ├── specs: 完整規格文件                                 │\n│  ├── commits: Git commit 記錄                            │\n│  ├── learnings: 詳細學習筆記                             │\n│  └── decisions: 完整決策文檔                             │\n└─────────────────────────────────────────────────────────┘\n```\n\n## 環境變數\n\n| 變數 | 說明 | 預設值 |\n|------|------|--------|\n| LETTA_API_KEY | Letta Cloud API Key | (必填) |\n| LETTA_AGENT_ID | 指定使用的 Agent ID | (選填，可在 Letta 後台建立) |\n| LETTA_BASE_URL | Letta API URL | https://api.letta.com |\n\n## 專案配置\n\n可在專案目錄建立 `.claude/letta.json` 覆蓋設定：\n\n```json\n{\n  \"agent_id\": \"agent-xxx\"\n}\n```\n\n## 開發\n\n```bash\n# Clone\ngit clone https://github.com/miles990/claude-dev-memory.git\ncd claude-dev-memory\n\n# 安裝依賴\nnpm install\n\n# 編譯\nnpm run build\n\n# 測試\nnpm test\n\n# 開發模式\nnpm run dev\n```\n\n## 相關專案\n\n- [claude-memory-hook](https://github.com/miles990/claude-memory-hook) - Claude Code session 啟動時自動載入記憶狀態\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-c1ce43b02413b1208e472e56cb897469"}