Memory Bank MCP Server

🚀 記憶銀行MCP服務器文檔

記憶銀行MCP服務器為客戶端提供數據存儲和管理服務，通過解析客戶端請求，對SQLite數據庫進行讀寫操作，實現項目信息的高效存儲與查詢。

🚀 快速開始

📦 安裝指南

1. 下載並安裝Node.js：訪問Node.js官網，下載並安裝適合您操作系統的最新版本。
2. 安裝項目依賴項：打開終端，導航到項目目錄，運行以下命令：

npm install

3. 啟動服務器：在項目根目錄下運行：

npm start

⚙️ 配置說明

• 環境變量配置：創建一個.env文件，並添加以下內容，可根據需要修改數據庫路徑：

DB_PATH=./memory-bank/memory.db

✨ 主要特性

🔄 請求處理流程

1. 客戶端請求：客戶端（如RooCode）發起工具調用請求到記憶銀行MCP服務器，通常包含section參數。
2. 解析請求：服務器核心接收並解析請求內容。
3. 路由邏輯：根據請求中的section參數確定目標數據庫表。
4. 處理邏輯：執行對應的讀寫操作。
5. 響應處理：將結果格式化為MCP響應，並返回給客戶端。

🗃️ 數據庫結構

記憶銀行的核心由以下SQLite表組成，用於存儲項目的關鍵信息：

• product_context：存儲項目背景、目標和範圍等高層次信息。
• decisions：記錄重要技術選擇、架構決策和產品方向調整。
• progress：跟蹤開發進展、狀態更新和完成任務。
• focus：定義當前或近期的開發重點和需要解決的問題。
• system_patterns：記錄可重用模式、常見解決方案和重要設計原則。

💻 使用示例

🛠️ 工具調用示例

基礎用法

創建新條目：

{
  "tool": "update_memory_bank_entry",
  "args": {
    "section": "decisions",
    "entry_data": {
      "reason": "採用模塊化架構以提高可維護性。",
      "outcome": "成功實施模塊化架構，減少了耦合度。"
    }
  }
}

高級用法

查詢歷史記錄：

{
  "tool": "get_memory_bank_section",
  "args": {
    "section": "progress",
    "limit": 5
  }
}

📚 詳細文檔

📊 數據流圖

graph TD
    Client["客戶端"] -- "工具調用\n（例如，更新條目，section='decisions'）" --> MCPServer["記憶銀行MCP服務器"]
    MCPServer -- "解析請求" --> Router{"路由/邏輯"}

    subgraph "數據庫交互"
        direction LR
        Router -- "section='product_context'?" --> Table_PC["product_context表"]
        Router -- "section='decisions'?" --> Table_DEC["decisions表"]
        Router -- "section='progress'?" --> Table_PROG["progress表"]
        Router -- "section='focus'?" --> Table_FOC["focus表"]
        Router -- "section='system_patterns'?" --> Table_SP["system_patterns表"]

        Table_PC -- "讀寫操作" --> SQLiteDB["SQLite數據庫"]
        Table_DEC -- "讀寫操作" --> SQLiteDB
        Table_PROG -- "讀寫操作" --> SQLiteDB
        Table_FOC -- "讀寫操作" --> SQLiteDB
        Table_SP -- "讀寫操作" --> SQLiteDB
    end

    SQLiteDB -- "操作結果" --> MCPServer
    MCPServer -- "格式化響應" --> Client

⚠️ 注意事項

⚠️ 重要提示

1. 確保.env文件中的數據庫路徑配置正確。
2. 定期檢查並更新項目依賴，以保持兼容性。
3. 關注服務器日誌，及時發現和處理錯誤。

📚 其他資源

• 參考文檔：
  • Node.js官方文檔
  • SQLite官方文檔

通過以上步驟和說明，您可以順利配置並使用記憶銀行MCP服務器。如有任何問題或建議，請隨時聯繫支持團隊。