Memory Bank MCP

用于AI辅助开发的引导式内存库插件

Memory Bank MCP 是一个模型上下文协议（MCP）插件，通过结构化的Markdown文件帮助AI助手维持持久的项目上下文。它提供了一种通过引导指令而不是直接操作来跟踪项目目标、决策、进度和模式的方法。

功能

• 引导操作：为AI助手提供执行操作的指令
• 结构化上下文管理：在5个核心文件中组织项目信息
• 智能引导：初始化和更新的逐步指导
• 灵活更新：基于不同变更类型提供的智能更新指导
• 跨平台支持：自动路径规范化以支持Windows/macOS/Linux

MCP配置

使用已发布的npm包：

{
  "mcpServers": {
    "memory-bank": {
      "command": "npx",
      "args": ["@neko0721/memory-bank-mcp"],
      "timeout": 600
    }
  }
}

快速开始

1. 初始化内存库

   使用 init-memory-bank 创建内存库目录和核心文件
   

2. 读取内存库

   使用 get-memory-bank-info 查看所有内存库内容
   

3. 更新内存库

   使用 update-memory-bank 获取更新特定文件的指导
   

核心文件

1. productContext.md (产品上下文)

• 高级项目概述
• 目标和关键特性
• 整体架构
• 自动整合项目简介（如果存在）

2. activeContext.md (活动上下文)

• 当前工作状态
• 最近的变化
• 开放的问题和问题
• 关注领域

3. progress.md (进度)

• 检查表格式的任务追踪
• 已完成、当前和计划的任务
• 进度时间线

4. decisionLog.md (决策日志)

• 架构和实现决策
• 原因和影响
• 决策历史

5. systemPatterns.md (系统模式)

• 重复出现的模式和标准
• 编码规范
• 架构模式
• 测试策略

使用指南

对于AI助手

1. 每次会话开始时：检查内存库目录是否存在，然后使用 get-memory-bank-info 了解项目状态
2. 需要时初始化：对于新项目使用 init-memory-bank
3. 阅读上下文：使用 get-memory-bank-info 了解项目状态
4. 更新指导：使用 update-memory-bank 获取更新指导
5. 遵循指导：执行提供的指导以维护内存库

更新触发器

• 架构变化：重大结构决策
• 功能完成：新功能或能力
• 错误修复：重要问题解决
• 重构：代码结构改进
• 决策：任何重要的技术选择
• 进度更新：任务状态变化

工具参考

init-memory-bank

初始化内存库及其所有核心文件。

参数：

• rootPath：项目根目录路径
• force（可选）：强制重新初始化

返回值： 创建的文件列表和下一步指导

get-memory-bank-info

读取并返回所有内存库内容（类似于codelf的get-project-info）。

参数：

• rootPath：项目根目录路径

返回值： 格式的内存库内容供AI上下文使用

update-memory-bank

提供更新内存库文件的指导。

参数：

• rootPath：项目根目录路径
• changeType：变更类型（架构/功能/错误修复/重构/决策/进度）
• description：变更的简要描述

返回值： 详细的更新指导，包括模板和时间戳

集成提示

Cursor设置

添加到设置 → 规则 → 用户规则：

在开始任何任务之前，检查项目中是否存在内存库目录。如果不存在，则运行MCP命令init-memory-bank。
在会话开始时使用MCP命令get-memory-bank-info读取内存库内容。
在完成任务或对话后，必须使用MCP命令update-memory-bank更新内存库内容。
遵循MCP指导以维护内存库文件。

Windsurf设置

添加到设置 → 级联 → 记忆和规则 → 全局规则：

在开始任何任务之前，检查项目中是否存在内存库目录。如果不存在，则运行MCP命令init-memory-bank。
在会话开始时使用MCP命令get-memory-bank-info读取内存库内容。
在完成任务或对话后，必须使用MCP命令update-memory-bank更新内存库内容。
遵循MCP指导以维护内存库文件。

贡献

欢迎贡献！请随时提交问题或拉请求。

许可证

MIT

致谢

灵感来自SPARC方法论和codelf。 </中文翻译>