Roo Code Memory Bank MCP Server

🚀 Roo代碼記憶銀行MCP服務器

本項目實現了 Roo Code Memory Bank 系統的核心功能，作為一個Model Context Protocol (MCP) 服務器。它能讓AI助手通過與基於文件的記憶銀行進行交互，從而維護跨會話的項目上下文。

✨ 主要特性

此MCP服務器提供了以下工具：

• initialize_memory_bank：創建 memory-bank/ 目錄，並生成標準 .md 文件（productContext.md、activeContext.md、progress.md、decisionLog.md、systemPatterns.md），同時填充初始模板。
  • 輸入：(可選) { "project_brief_content": string }
  • 輸出：{ "status": "success" | "error", "messages": Array<string> }
• check_memory_bank_status：檢查 memory-bank/ 目錄是否存在，並返回其狀態。
  • 輸入：無
  • 輸出：{ "exists": boolean, "message": string }
• read_memory_bank_file：讀取並返回指定的 .md 文件內容。
  • 輸入：{ "file_name": string }
  • 輸出：{ "content": string, "error": null | string }
• append_memory_bank_entry：將指定內容追加到指定的 .md 文件中。
  • 輸入：{ "file_name": string, "entry_content": string }
  • 輸出：{ "status": "success" | "error", "message": string }
• initialize_memory_bank：初始化一個新的記憶銀行，包括生成所有必要的初始文件和目錄結構。
  • 輸入：無
  • 輸出：{ "status": "success" | "error", "message": string }

📦 安裝指南

先決條件

要使用此MCP服務器，請確保滿足以下條件：

1. 您已安裝 Node.js 和 npm。
2. 您熟悉基本的命令行操作和文件管理。

安裝步驟

按照以下步驟安裝並運行MCP服務器：

1. 克隆此倉庫到本地機器。
2. 打開終端或命令提示符，導航到倉庫根目錄。
3. 運行 npm install 安裝所有依賴項。
4. 啟動服務器：node index.js 或使用 npm start。

📚 詳細文檔

配置

針對Cline MCP客戶端的配置如下： 在您的項目中添加以下內容到 config.json 文件：

{
  "mcp_servers": {
    "roo_code_memory_bank": {
      "url": "http://localhost:3000",
      "auth_token": "your_auth_token_here"
    }
  }
}

運行

此服務器將在本地運行，默認端口為 3000。

使用說明

• 在開始任何任務或重要子任務時，使用 check_memory_bank_status。
• 如果記憶銀行存在 (exists: true)，使用 read_memory_bank_file 讀取相關文件（例如 productContext.md、activeContext.md）以加載當前項目上下文。
• 將此加載的上下文融入到您的計劃和執行中。
• 在做出重要決策、進度更新或架構更改時，使用 append_memory_bank_entry 記錄信息到適當的文件（例如 decisionLog.md、progress.md）以確保上下文持久性。
• 如果記憶銀行不存在，請考慮在項目中使用 initialize_memory_bank。

自定義指令

在Roo中設置這些指令： 您必須在需要的地方使用MCP。 我有一個特定的MCP流程：

1. 使用 context7 來查找任何相關文檔片段，您將需要為每個子任務執行此操作。確保將所有相關知識傳遞給任何相關子任務，並始終使用 context7 進行研究，如果您對某些內容不確定。
2. 使用 google maps mcp 搜索 <niche> + <county>，這將幫助我們找到完成任務所需的基本企業信息。
3. 使用 brave search mcp 找到 URLs 以進行抓取。
4. 使用 fetch mcp 與 fetch_txt 和 fetch_markdown 來查找頁面上的文本和圖像，並將其轉換為深度的 JSON 文件。

利用 roo-code-memory-bank-mcp 服務器來維護項目上下文：

• 在開始任務或重要子任務時，使用 check_memory_bank_status。
• 如果記憶銀行存在 (exists: true)，使用 read_memory_bank_file 讀取相關文件（例如 productContext.md、activeContext.md）以加載當前項目上下文。
• 將此加載的上下文融入到您的計劃和執行中。
• 在做出重要決策、進度更新或架構更改時，使用 append_memory_bank_entry 記錄信息到適當的文件（例如 decisionLog.md、progress.md）以確保上下文持久性。
• 如果記憶銀行不存在，請考慮在項目中使用 initialize_memory_bank。