Skip to content

Unified SQLite Memory MCP Server for Claude Code ecosystem

Notifications You must be signed in to change notification settings

miles990/sqlite-memory-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sqlite-memory-mcp

npm version License: MIT

統一的 SQLite Memory MCP Server,為 Claude Code 生態系提供智能記憶管理

特色

  • 跨專案記憶共享 — 學一次,處處可用
  • FTS5 全文搜尋 — 毫秒級搜尋,精確匹配
  • Skill 效果追蹤 — 知道什麼最有效
  • 失敗經驗索引 — 不重複犯錯
  • Context 狀態共享 — 跨 Skill 無縫傳遞
  • 零外部依賴 — 純 SQLite,無需 PyTorch/ONNX

效能

指標 傳統方案 sqlite-memory-mcp
Token/搜尋 ~2300 ~200 (-91%)
搜尋速度 ~20ms ~3.5ms (5.7x)
外部依賴 PyTorch/ONNX
並發支援 JSONL 無 SQLite WAL

安裝

從 npm 安裝(推薦)

npm install -g sqlite-memory-mcp

從源碼安裝

git clone https://github.com/miles990/claude-memory-mcp.git
cd claude-memory-mcp
npm install
npm run build

配置 Claude Code

~/.claude/.mcp.json 加入:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["sqlite-memory-mcp"]
    }
  }
}

或如果從源碼安裝:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/claude-memory-mcp/dist/index.js"]
    }
  }
}

工具列表 (23 tools)

Memory 工具 (6)

工具 說明
memory_write 寫入記憶到知識庫
memory_read 讀取特定記憶
memory_search FTS5 全文搜尋
memory_list 列出記憶(可過濾)
memory_delete 刪除記憶
memory_stats 統計資訊

Skill 工具 (7)

工具 說明
skill_register 註冊 skill 安裝
skill_get 取得 skill 資訊
skill_list 列出所有 skill
skill_usage_start 開始使用追蹤
skill_usage_end 結束使用追蹤
skill_recommend 智能推薦(基於成功率)
skill_stats 使用統計

Context 工具 (5)

工具 說明
context_set 設定 context 值
context_get 取得 context 值
context_list 列出 session context
context_clear 清除 context
context_share 跨 session 共享

Failure 工具 (5)

工具 說明
failure_record 記錄失敗經驗
failure_search FTS5 搜尋解法
failure_list 列出失敗記錄
failure_update 更新解法
failure_stats 失敗統計

資料庫

位置:~/.claude/claude.db

自動建立 schema,包含:

  • memory 表 + memory_fts FTS5
  • skills
  • skill_usage
  • failures 表 + failures_fts FTS5
  • context

使用範例

記憶搜尋

memory_search query="TypeScript pattern"
memory_list scope="global"

Skill 追蹤

skill_usage_start skill_name="evolve"
skill_usage_end usage_id=1 success=true outcome="completed"
skill_recommend project_type="typescript"

失敗經驗

failure_record error_pattern="TypeError: undefined" solution="Check null values"
failure_search query="TypeError undefined"

與競品比較

功能 server-memory doobidoo sqlite-memory-mcp
存儲 JSONL SQLite-vec SQLite WAL
搜尋 關鍵字 向量 FTS5 全文
Skill 追蹤 - -
失敗索引 - -
Context 共享 - -
外部依賴 PyTorch

與 evolve skill 整合

此 MCP Server 設計為與 self-evolving-agent 整合:

  • CP1: 使用 memory_search + failure_search 搜尋經驗
  • CP3.5: 使用 memory_write 記錄學習
  • CP5: 使用 failure_record 記錄失敗
  • Skill 追蹤: 自動追蹤使用成功率

License

MIT

About

Unified SQLite Memory MCP Server for Claude Code ecosystem

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •