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 创建初始结构。

🔧 技术细节

文档中未提供足够详细的技术实现细节，此部分跳过。

📄 许可证

文档中未提及许可证信息，此部分跳过。