memory-bank-mcp-server

🚀 记忆银行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服务器。如有任何问题或建议，请随时联系支持团队。