Roo Code Memory Bank

🚀 代碼內存銀行 MCP 服務器

該項目實現了 Roo Code Memory Bank 系統的核心功能，作為一個 Model Context Protocol (MCP) 服務器。它允許 AI 助手通過持久化存儲來維護和共享項目上下文，為項目管理和協作提供了有力支持。

✨ 主要特性

初始化內存銀行

• 創建 memory-bank 目錄。
• 生成初始模板文件：productContext.md、activeContext.md、decisionLog.md、progress.md 和 architecturalDecisions.md。

檢查內存銀行狀態

• 確認內存銀行是否存在（返回布爾值）。

讀取文件內容

• 加載並解析指定的 .md 文件，獲取項目上下文信息。

追加條目記錄

• 向相關文件中追加新的條目或更新現有內容，確保記錄重要決策、進展和架構變更。

📦 安裝指南

文檔中未提及安裝步驟，此部分跳過。

💻 使用示例

基礎用法

以下是使用該 MCP 服務器的基本流程示例：

# 初始化內存銀行
initialize_memory_bank()

# 檢查內存銀行狀態
if check_memory_bank_status():
    # 加載上下文信息
    product_context = read_memory_bank_file('productContext.md')
    active_context = read_memory_bank_file('activeContext.md')
    # 記錄重要變更
    append_memory_bank_entry('decisionLog.md', '做出了一個重要決策')

高級用法

在自定義流程和 MCP 工具集成場景下的使用示例：

# 啟動時檢查內存銀行
if check_memory_bank_status():
    # 加載當前上下文
    current_context = read_memory_bank_file('activeContext.md')
    # 記錄重要事件
    append_memory_bank_entry('progress.md', '完成了某個關鍵任務')

# MCP 工具集成示例
# 使用 Context7 查找和整合所需文檔
# 使用 Google Maps 搜索特定領域的企業
# 使用 Brave Search 尋找網頁鏈接以便抓取內容
# 使用 Fetch 獲取網頁內容並轉換為結構化數據
# 使用 OpenRouter 分析主題情感和評論

📚 詳細文檔

使用說明

1. 初始化內存銀行

   • 在新項目開始時使用 initialize_memory_bank 創建基礎結構。

2. 檢查內存銀行狀態

   • 開始任務或重要子任務前，調用 check_memory_bank_status 確認上下文的存在性。

3. 加載上下文信息

   • 使用 read_memory_bank_file 加載相關文件內容，如 productContext.md 和 activeContext.md，以獲取當前項目狀態。

4. 記錄重要變更

   • 在做出決策或更新進展時，使用 append_memory_bank_entry 向 decisionLog.md 或 progress.md 中添加記錄。

配置說明

在 MCP 客戶端配置文件中添加以下內容：

"roo-code-memory-bank-mcp": {
  "autoapprove_tools": ["initialize_memory_bank", "check_memory_bank_status", "read_memory_bank_file", "append_memory_bank_entry"],
  "command": "node index.js"
}

執行指令

自定義流程

1. 啟動時檢查內存銀行

   • 使用 check_memory_bank_status 確認上下文是否存在。

2. 加載當前上下文

   • 調用 read_memory_bank_file 加載相關文件內容，確保AI助手獲取最新信息。

3. 記錄重要事件

   • 使用 append_memory_bank_entry 記錄決策、進展或架構變更。

MCP 工具集成

• Context7：查找和整合所需文檔。
• Google Maps：搜索特定領域的企業。
• Brave Search：尋找網頁鏈接以便抓取內容。
• Fetch：使用 fetch_txt 和 fetch_markdown 獲取網頁內容並轉換為結構化數據。
• OpenRouter：分析主題情感和評論。

項目上下文維護

始終使用 roo-code-memory-bank-mcp 服務器來保存項目狀態：

1. 任務開始時

   • 調用 check_memory_bank_status 確認上下文存在性。

2. 加載上下文信息

   • 使用 read_memory_bank_file 獲取相關文件內容，確保AI助手瞭解當前項目背景。

3. 記錄關鍵決策和進展

   • 通過 append_memory_bank_entry 更新 decisionLog.md 或 progress.md 文件，保持項目記憶。

4. 初始化新項目

   • 若上下文不存在且為新項目，使用 initialize_memory_bank 創建初始結構。

🔧 技術細節

文檔中未提供足夠詳細的技術實現細節，此部分跳過。

📄 許可證

文檔中未提及許可證信息，此部分跳過。