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。