🚀 记忆银行MCP服务器文档

记忆银行MCP服务器为客户端提供数据存储和管理服务，通过解析客户端请求，对SQLite数据库进行读写操作，实现项目信息的高效存储与查询。

🚀 快速开始

📦 安装指南

1. 下载并安装Node.js：访问Node.js官网，下载并安装适合您操作系统的最新版本。
2. 安装项目依赖项：打开终端，导航到项目目录，运行以下命令：

npm install

3. 启动服务器：在项目根目录下运行：

npm start

⚙️ 配置说明

• 环境变量配置：创建一个.env文件，并添加以下内容，可根据需要修改数据库路径：

DB_PATH=./memory-bank/memory.db

✨ 主要特性

🔄 请求处理流程

1. 客户端请求：客户端（如RooCode）发起工具调用请求到记忆银行MCP服务器，通常包含section参数。
2. 解析请求：服务器核心接收并解析请求内容。
3. 路由逻辑：根据请求中的section参数确定目标数据库表。
4. 处理逻辑：执行对应的读写操作。
5. 响应处理：将结果格式化为MCP响应，并返回给客户端。

🗃️ 数据库结构

记忆银行的核心由以下SQLite表组成，用于存储项目的关键信息：

• product_context：存储项目背景、目标和范围等高层次信息。
• decisions：记录重要技术选择、架构决策和产品方向调整。
• progress：跟踪开发进展、状态更新和完成任务。
• focus：定义当前或近期的开发重点和需要解决的问题。
• system_patterns：记录可重用模式、常见解决方案和重要设计原则。

💻 使用示例

🛠️ 工具调用示例

基础用法

创建新条目：

{
  "tool": "update_memory_bank_entry",
  "args": {
    "section": "decisions",
    "entry_data": {
      "reason": "采用模块化架构以提高可维护性。",
      "outcome": "成功实施模块化架构，减少了耦合度。"
    }
  }
}

高级用法

查询历史记录：

{
  "tool": "get_memory_bank_section",
  "args": {
    "section": "progress",
    "limit": 5
  }
}

📚 详细文档

📊 数据流图

graph TD
    Client["客户端"] -- "工具调用\n（例如，更新条目，section='decisions'）" --> MCPServer["记忆银行MCP服务器"]
    MCPServer -- "解析请求" --> Router{"路由/逻辑"}

    subgraph "数据库交互"
        direction LR
        Router -- "section='product_context'?" --> Table_PC["product_context表"]
        Router -- "section='decisions'?" --> Table_DEC["decisions表"]
        Router -- "section='progress'?" --> Table_PROG["progress表"]
        Router -- "section='focus'?" --> Table_FOC["focus表"]
        Router -- "section='system_patterns'?" --> Table_SP["system_patterns表"]

        Table_PC -- "读写操作" --> SQLiteDB["SQLite数据库"]
        Table_DEC -- "读写操作" --> SQLiteDB
        Table_PROG -- "读写操作" --> SQLiteDB
        Table_FOC -- "读写操作" --> SQLiteDB
        Table_SP -- "读写操作" --> SQLiteDB
    end

    SQLiteDB -- "操作结果" --> MCPServer
    MCPServer -- "格式化响应" --> Client

⚠️ 注意事项

⚠️ 重要提示

1. 确保.env文件中的数据库路径配置正确。
2. 定期检查并更新项目依赖，以保持兼容性。
3. 关注服务器日志，及时发现和处理错误。

📚 其他资源

• 参考文档：
  • Node.js官方文档
  • SQLite官方文档

通过以上步骤和说明，您可以顺利配置并使用记忆银行MCP服务器。如有任何问题或建议，请随时联系支持团队。