Long Term Memory

🚀 記憶 MCP 服務器

記憶 MCP 服務器是一個專為大型語言模型 (LLMs) 設計的長期記憶存儲系統，它遵循 Model Context Protocol (MCP) 標準。該系統能助力 LLMs 記住整個項目歷史中的上下文信息，即便跨越多個會話也能輕鬆實現。它藉助語義搜索和嵌入式向量技術，為過去的交互和決策提供相關上下文。

🚀 快速開始

先決條件

• Node.js (v18 或更高版本)
• 在本地運行 Ollama（用於嵌入），且必須安裝 nomic-embed-text 模型
• SQLite3

安裝步驟

1. 克隆倉庫。
2. 安裝依賴：

   npm install
   

3. 構建項目：

   npm run build
   

4. 創建配置文件 .env：

   OLLAMA_HOST=http://localhost:11434
   DB_PATH=memory.db
   

使用方法

1. 以開發模式啟動服務器：

   npm run dev
   

   這將：

   • 編譯 TypeScript
   • 複製 schema 文件
   • 啟動帶有自動重載功能的服務器

2. 通過標準輸入輸出與 Cursor 兼容連接

✨ 主要特性

• 基於項目的記憶組織：按項目管理記憶。
• 語義搜索：使用 Ollama 嵌入（nomic-embed-text 模型，768 維度）。
• 多種記憶類型：
  • 對話：對話上下文和重要討論。
  • 代碼：實現細節和更改。
  • 決策：關鍵架構和設計選擇。
  • 引用：外部資源和文檔鏈接。
• 豐富的元數據存儲，包括：
  • 實現狀態
  • 關鍵決策
  • 創建/修改的文件
  • 代碼更改
  • 添加的依賴項
• 標籤系統：用於記憶組織。
• 關係跟蹤：在記憶之間建立聯繫。

📚 詳細文檔

數據庫架構

系統使用 SQLite，包含以下表：

核心表

• projects：項目信息和元數據。
• memories：存儲各種開發上下文的記憶條目。
• embeddings：語義搜索的嵌入式向量（768 維度）。

組織表

• tags：記憶組織標籤。
• memory_tags：記憶與標籤之間的多對多關係。
• memory_relationships：記憶條目之間的有向關係。

MCP 工具

以下工具通過 MCP 協議可用：

記憶管理

• store-dev-memory：創建新的開發記憶，包含：
  • 內容
  • 類型（對話/代碼/決策/引用）
  • 標籤
  • 代碼更改
  • 創建/修改的文件
  • 關鍵決策
  • 實現狀態
• list-dev-memories：列出現有記憶，可選標籤過濾。
• get-dev-memory：通過 ID 獲取特定記憶。
• search：語義搜索，跨記憶使用嵌入式向量。

開發環境

在開發時：

npm run dev

這將：

1. 殺死現有服務器實例。
2. 重建 TypeScript 代碼。
3. 將 schema.sql 複製到 dist 目錄。
4. 啟動開發模式的服務器。

依賴項

關鍵依賴：

• @modelcontextprotocol/sdk@^1.7.0：MCP 協議實現。
• better-sqlite3@^9.4.3：SQLite 數據庫接口。
• node-fetch@^3.3.2：Ollama API 的 HTTP 客戶端。
• zod@^3.22.4：運行時類型檢查和驗證。

項目結構

memory-mcp-server/
├── src/
│   ├── db/
│   │   ├── init.ts     # 數據庫初始化
│   │   └── service.ts  # 數據庫服務層
│   ├── memory.js      # 記憶管理邏輯
│   └── search.js      # 語義搜索功能
├── package.json       # 依賴管理和腳本
└── .env               # 環境變量配置

💻 使用示例

基礎用法

1. 安裝後，設置環境變量：

   export OLLAMA_HOST=http://localhost:11434
   export DB_PATH=memory.db
   

2. 啟動服務器：

   npm run dev
   

3. 使用工具：
   • 存儲記憶：

     nomic store-dev-memory --content "這是一個測試記憶" --tags test,example
     

   • 列出記憶：

     nomic list-dev-memories
     

   • 搜索記憶：

     nomic search --query example
     

⚠️ 重要提示

• 確保 Ollama 服務在本地運行，並且 nomic-embed-text 模型已加載。
• 數據庫文件 (memory.db) 會在項目目錄中創建，用於存儲記憶數據。
• 代碼和配置文件請根據具體需求進行調整。

🤝 貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 參與開發。